Jevis is a lightweight set of hooks for coding agents. At key moments in a session — start, every message, and right before certain commands — it drops a short reminder into the agent's context.
Tips live in plain Markdown files you can read, edit, or turn off. Code picks them locally: no API key, no network call.
Example — an agent is about to run grep -rn TODO src:
- Without Jevis:
grepruns as normal. - With Jevis: the command still runs, and the agent gets: "Search with
rginstead ofgrepandfdinstead offind: they are installed here, faster, and respect.gitignore."
Jevis never blocks a tool call or an edit. It only sends the agent back in two cases: when its final message claims checks pass even though a check failed after the last edit, or when the optional visual design review spots real fixes. See Tips and hooks for every hook and tip.
Honest note on evidence: the current fixed tips replaced an earlier LLM-heavy version (v1) that turned out noisy and expensive. I haven't formally benchmarked the new tips yet — see Evidence for what was measured in v1 and how to judge Jevis on your own work.
Requires Node 22+. The installer handles Claude Code and Codex; Gemini CLI, Antigravity, and Muse Code are wired by hand.
git clone https://github.com/GLDRoger/jevis.git ~/code/jevis
cd ~/code/jevis && npm install
node bin/install.mjs --critic off --dry-run # preview changes to ~/.claude/settings.json and ~/.codex/hooks.json
node bin/install.mjs --critic off # install (backs up old configs to ~/.jevis/backups/)
node bin/jevis.mjs doctor # verify everything--critic off is the cleanest starting point: fixed tips + the end-of-turn pass-claim check, with zero API keys or external calls. Leave off --critic off if you want the automated visual design review (defaults to Claude as reviewer). Hooks activate on your next session; Codex asks you to approve them once.
- Tips and hooks — every hook moment, every shipped tip, overriding tips, and worker sessions.
- Configuration — installer flags, design review, decision model, env vars, files, cost, and inspection commands.
- Other harnesses — Gemini CLI, Antigravity, Muse Code, the Codex plugin, manual setup, and Windows.
- Writing lessons — custom content-aware checks for commands, edits, or turn endings.
- Evidence — v1 audit numbers, simulation results, and how to test Jevis on your own work.
- Beast and Jevis — how Jevis pairs with Beast's standing instruction files.
- Overview page — single-page HTML summary with every shipped tip.
See CONTRIBUTING.md, SECURITY.md, and LICENSE (MIT).