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.

• Getting started · Command reference
• Project memory · Evidence check · Updating
• Hosts, surface by surface
• Repository architecture · Changelog

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.