jevieDocs Download

↑↓ pick↵ openesc close

Make it yours

Improve Jevie

Type how Jevie should be different and press return: it becomes a rule, a routine, an extension, or a change to Jevie's own code, whichever is the smallest that grants it. Every wish can be taken back.

FreeMacCoding agent

Jevie’s palette, as the app draws it. Press a sentence on this page to see it, and to copy it.

Use itHow it worksLimitsWhere it's kept

Use it

How it works

As you type a wish, a card under the field shows it and where it will most likely land. Return sends it.

Jevie tries the smallest change first. A wish already worded as a rule (always …, never …), a name (my wiki is …), a routine (when I say …) or an extension (make me an extension that …) goes straight to that, decided in code. Anything else is placed by one model call, and the result is checked in code: when the smaller change does not really hold the wish, it goes to Jevie's code instead of a guess.

A wish only code can grant becomes an improvement card. Your coding agent builds it on a branch of its own, with a test written first, and the improvement loop judges it the way it judges every card. A wish about how something looks waits for your look. You are notified when it is judged. Say merge card <id> to take it, or let wishes merge themselves. Then a change to Jevie's daemon goes live at once, and a change to the Mac app waits for its next build.

What was in front when you wished (the app, what was in focus, what you asked last) goes with the wish, so this means what it meant then.

Limits

Where it's kept

Wishes are kept in ~/.jevie/wishes.json; rules and names in ~/.jevie/self; extension drafts in ~/.jevie/extension-drafts; code wishes as improvement cards in ~/.jevie/improve/cards.json, built in ~/.jevie/worktrees/improve-<id> on the branch improve/<id>.

In Jevie, help improve jevie answers from this page as you type.

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