grimoire-kit
Grimoire installs into your repository and gives you, for the code you delegate to agents
(Claude Code, Copilot), a local dashboard, tasks, project memory and an evidence check.
Website ·
Manual (in French) ·
Version française
uv tool install grimoire-kit # or: pipx install grimoire-kit
grimoire init . --lite -y # sets up the current repository, light profile (no service)
grimoire standard init . --profile governed # makes the evidence check blocking
The five tools
The dashboard
A local web page that gathers the Grimoire projects on your machine and their tasks. Started
from a project, it adds that project and opens on it; it does not start sessions, that stays
in your editor.
grimoire cockpit start # starts in the background and opens the browser
Tasks
Each piece of work becomes a task with an acceptance criterion. A session takes a task and
hands its work back to you for review.
grimoire task add "Fix the CSV export" -a "pytest tests/test_export.py passes" --ready
Project memory
What the project decided carries over from one session to the next. Memory belongs to each
project; in the light profile it needs no service.
grimoire memory remember "We keep SQLite while the volume allows it"
Evidence check
Before a task changes state, Grimoire checks that its evidence exists: a test run, a written
review, a produced file. It refuses for real in the governed profile and warns elsewhere;
either way, it names what is missing.
grimoire standard gate check # tells which evidence is missing, if any
Install
Start small and enable only what the project needs. Updating goes through a backup and a
preview; anything that needs your call is proposed instead of applied.
grimoire upgrade-flow run # guided update, backup first
Under the hood
The manual is in French.
Contributing
Issues and change proposals are welcome. The path (environment, tests, contribution rules) is
in CONTRIBUTING.md. A change to a command updates its reference page in the
same commit.
License
MIT — see LICENSE.
