Get started

Installing and updating

Install Jevie on a Mac, Windows or Linux, learn it in a guided first run of about four minutes, plus the connections you choose, and let it check and update itself.

FreeMacWindowsAccessibility

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

Use itHow it worksLimitsWhere it's kept

Use it

• doctorsetup checkJevie checks its permissions, tools and Chrome extension, and names what is missing; ↵ on a row that is not working starts your coding agent to fix it
• open jevie://updateCheck for an update now (it also checks daily)
• open jevie://onboardingThe first run again, from the start (show me around says it)
• open jevie://onboarding?exploreThe Explore board alone: short chapters to try, each ticked once tried
• open jevie://onboarding?classicThe older first run on its dark stage, while it is still kept
• open jevie://setup → Getting startedWhat the first run left for later
• sj means start claude in jevieA word of your own, as the first run teaches
• explain updates in jevieHow updating works, from these docs
• uninstall JevieEverything Jevie put on the Mac removed, after one question (uninstalling)

How it works

The first run (First Light) takes about four minutes and plays on a stage over your desktop with the menu bar kept (the tour has it scene by scene), with very quiet music that comes to its own end on the last screen: M, or the ♫ beside Jevie's name, turns it off, and ⌘⇧M mutes every sound. It greets you, lets you pick your look, and asks for the permissions, each with what it is for. Then you press ⌘ Space yourself: open Jevie, type downloads, hide it (if Spotlight has ⌘ Space, one click moves it to ⌥ Space and Undo puts it back).

Then everything Jevie does on one screen, as films of its own palette, so nothing on your Mac is touched, and your phone; who answers for you; ⌘ twice to talk, tried for real; your plan (a free week, then Care; Return starts the free week, never a payment); and You're set, with two switches: open Jevie when your Mac starts (on) and share usage counts (off until you turn it on). Skip moves past a step; Close (or Esc on the stage) ends the tour, and the next launch picks up at the same scene; closed twice, it stops asking; closed on the plan or the last screen, it is finished.

Jevie asks for each permission on the permissions page, each with its own button: Accessibility in System Settings, where Jevie says what to find (Jevie and JevieAX, its helper that clicks and types for you; neither takes pictures of your screen); the Microphone by macOS's own alert; Screen Recording only if you press its Allow (optional: macOS then reopens Jevie, and the tour picks up there); the Chrome extension if Chrome is here. Skipped, the voice tries say they need Accessibility and offer it again. Updates download in the background, are checked against the signature of the app you have, and install when the palette is closed, permissions kept.

Limits

• Until the app is notarised, the first download needs right-click → Open once.
• A change of signing certificate asks for the permissions again, once.
• A copy built from source never updates itself.

Where it's kept

The app in /Applications/Jevie.app; its log in ~/.jevie/palette.log (each update step says update: …); everything Jevie keeps in ~/.jevie. More: docs/installing-jevie.md, docs/updates.md.

In Jevie, help first run answers from this page as you type.

Related

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