Get started

Show me around

A short tour of what Jevie does, tried on your own Mac: say show me around whenever you want it back.

FreeMac

Choose an example to copy it, then try it in Jevie.

Use itHow it worksLimitsWhere it's kept

Use it

• show me aroundThe tour again, from the start
• give me a tourtake the tour againThe same tour
• start the tourfirst lightThe tour by its own name
• walkthroughThe same tour as a row in the palette (Help › Walkthrough), as Raycast names its own; ↵ opens it
• open jevie://onboarding?exploreThe Explore board alone
• how does the explore board work in jevieHow it works, from these docs

How it works

The first time Jevie opens, it runs a short tour in a dark glass window on your desktop: a valley painted at dawn, where the sun rises as you go. The side of the window shows the same four chapters from first screen to last (Start, Try it, You decide, Last steps): the one you are in opens its steps under its name, the others show a name and a mark, and any of them jumps there. A row ticks only when that step really happened; a step you went past without doing it keeps a dash, and the side says what the dash means and that pressing it goes back.

Every step has Back (except the first) and Continue, quiet before the step is done (Continue without it where going on costs something) and bright after it, so nothing can hold you up. Under the chapters, Stuck? Ask me opens the palette with help in it.

• Hello. Jevie, mon ami. and one line: say what you want, your Mac does it. Tap Jevie on the hill and he thanks you.
• Your look. Make it yours: six looks and seven characters up front, Surprise me, and Describe me: say a space cat or anything else and he turns into the nearest of the cast at once. More, on the same page, has everything else: the rest of the living themes, all the named themes, the whole cast, the eight colours and his name. Point at one and Jevie wears it while you look; a click keeps it. In words he is Jevie unless you rename him, whichever character he wears.
• Shortcut. Hold the key, ⌘ Command or ⌥ Option, then tap Space, for real. It needs no permission. If Spotlight, your Mac's search, has ⌘ Space, this step settles it first: use ⌘ Command and Spotlight moves to ⌥ Space (Undo puts it back), or use ⌥ Option and Spotlight stays on ⌘ Space. Continue does the second, and says so. If another launcher holds the key, macOS does not say so: Jevie offers ⌥ Option + Space, because once Accessibility is on he may take ⌘ Space over from it. The row ticks only when the key that will really work has opened Jevie; the keys on the screen show what pressing them does, but only the key itself counts. Press the key and the real palette opens; close it with Esc, the same key or a click outside, and the tour goes on by itself. Never pressed, a quiet Continue goes on anyway. From here the side of the window, the tour, All set and the last moment all name that one key.
• What I can do. Tabs (Ask, Files, Reminders, Apps, Answers, and Agents where a coding tool is on this Mac), each a short film of Jevie's real palette, in the palette's own look and width, showing the one thing its title says. Each film is marked Example because what it shows is invented: it is there to watch. Try it if you like opens the real palette with that sentence typed, you press Return, and only then does the tab tick; Next never waits for it.
• Permissions. One at a time, in order: Accessibility, the one the run needs (it lets Jevie read, press and type in your apps and hear you tap ⌘ twice; only what a sentence needs leaves this Mac, and you take it back any time in System Settings), then Screen Recording and the Chrome extension, both optional. System Settings opens at the first one still off with a small card beside it: drag Jevie in, or flip the switch if he is listed already. macOS may ask for Touch ID or your password; the tour simply waits, with no time limit, and cancelling leaves the card where it was. The moment macOS says it is on, with nothing to press, the card says so and the next one opens by itself. What is already on gets a tick and is skipped, and Chrome's row is there only if Chrome is on this Mac. Screen Recording often offers Quit & Reopen and may not count until you take it: Jevie comes back to this step by itself. Every card has Back, Continue without it, and Open again if Settings goes away; after 25 seconds it says what to do if the switch looks on but nothing happens, since macOS ties a grant to one build of an app. After the last one Settings closes if the tour opened it, and the tour goes on. Coming back to the step shows the list of what stands, each with its own switch, and the sentence that says what leaves this Mac: what does jevie send.
• Talk. The microphone is asked for here, right before you talk. Tap ⌘ twice and I answer: first listening, then the answer in the real palette, then the words as heard with one line for each thing done, each ticked in turn, even for one sentence that asks for three things. The sentence to try shows your Downloads, sets a ten-second timer you see count down, and opens Calculator. Hold ⌘ alone and I type your words in any app; while ⌘ stays down the line at the foot says ⌘C and other shortcuts never start it. This comes after Permissions because macOS lets Jevie hear those keys only with Accessibility; without it, the step says so in one line and offers to go back, and Continue still works.
• You're in charge. What you say, Jevie does; if unsure, it asks. A practice card: Quit Safari? with Yes, Always, No and Never. It never quits anything and never changes a real approval; it says what would have happened, and Ask again puts the question back. Under it: sending something out and an agent's commands wait for your yes, unless you said always (approvals).
• AI. What is ready on this Mac and Jevie Cloud, with no account; when Jevie Cloud is the one way ready, the title says so instead of asking. It says who answers, naming every company that can get a request, what leaves this Mac and what is kept, that keystrokes are never logged, and what it costs. Picking one tries it for real: Trying it for real, then It works. More lists what is on this Mac but not signed in (Sign in copies the command and opens Terminal, and it comes up here once you are signed in) and takes a key of your own (from typesafe.ai).
• Phone. Before anything starts it says what it takes (Tailscale, a free app that links your own devices privately, on your phone, signed in to the same account), what a paired phone reaches (asking Jevie anything, opening apps and pages on this Mac, any coding work running here) and what it costs (included in your free week; after it, pairing a phone needs Care). Then sign in once to make your private link (the page that opens is Tailscale's) and point your phone's camera at the code, good for 10 minutes; No Tailscale yet? beside it swaps in a code for Tailscale's download page. Nothing starts until you press. Continue moves on; any time, say pair my phone. Once paired it says how to unpair: unpair my phone. Once paired, your phone offers to open an app on this Mac, and the Mac shows that app, and says so, only when it really happened.
• Plan. Your free week has begun, until its date, with no card (the week starts when Jevie first sets up on this Mac). It says what happens on day 8: nothing is charged, apps, files and dictation stay free, and AI needs Care or your own AI. Care beside it at $3.99 a month, AI included at 15,000 credits a month (about 20 an answer, 800 a long task), with your phone and a second Mac. Continue keeps the free week; a payment is only ever Care's own button. With a key of your own no free week runs, so the step says Jevie is yours, free, with Care beside it; already paying, it says he is in good hands. It stays until you press Continue.
• Moving around. A practice list, marked Example, and the keys around the palette: ⌘ J and ⌘ K (or ↓ and ↑) move down and up it, ⌘ L goes into a row that nests, such as a folder, and ⌘ H comes back up, and the list says which key did what as it lights; ⌘ . opens every action of the row in hand, ⌘ P a preview; Return says what would open, ⌘ Z undoes, Esc closes. Press each or click its card and the list does it; a key counts only when it acted, the count is of all nine keys, and nothing real opens or moves. Then Lost? Just ask.: the real help list, starting with what a new person asks.
• All set. The keys that work now, moving around included, whether Jevie opens when your Mac starts (on) and whether to share usage counts (off until you say yes), and how to see all this again: show me around. Start using Jevie, and Jevie stands on your desktop a moment, says he is out of sight until you press his key, gives a first thing to try (set a timer for 5 minutes), and flies up and is gone. He has no Dock or menu bar icon: his key is how you reach him.

Asked outside the tour: Chrome's sign-ins. The first time a page on the wall wants one, Jevie says why, and only then does macOS ask to let it read Chrome's key.

Esc, the window's red light or Pause setup ends the tour; closed midway, it picks up at the same step next time. Esc in the palette during a try only closes the palette, and Esc in another app is that app's. To walk through setup as a new Mac would, even with everything allowed, open jevie://onboarding?fresh=1; there it does not see a switch that was already on, so Continue without it goes past each one.

Limits

• The tour is drawn by the Mac app; on Windows show me around opens Windows' own first run from the start.
• Friends and backers are not in the tour; they are offered later, after real use.
• The phone chapter needs the phone app and Tailscale on both devices, and Care or the free week.

Where it's kept

The tour and the board are the Mac app's (jevie/macos/FirstLight.swift, FirstLightFlow.swift; the board is jevie://onboarding?explore). What this Mac has and what you ticked: jevie/kernel/onboarding/first-light.mjs, kept in ~/.jevie/first-light.json. The sample folder: ~/Library/Application Support/Jevie/Sample. The sentence: jevie/surfaces/help/tour.mjs.

In Jevie, help show me around answers from this page as you type.

Related

Updated 6 November 2026 · Something wrong or missing? Tell us