A lightweight plan-do-review-finalize process for your CLI agents.
Claude Code, Gemini CLI, Antigravity, OpenCode, Kilo Code, Codex CLI, Qwen Code
Mac/Linux:
curl -sSL https://raw.githubusercontent.com/bdhrs/kamma/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/bdhrs/kamma/main/install.ps1 | iexDownloads the latest version to ~/kamma and syncs to all installed AI tools. Re-run any time to update.
Requires uv. The script will offer to install it if missing.
git clone https://github.com/bdhrs/kamma.git
cd kammaThen sync:
# With just
just sync
# Reinstall the local kammika CLI after changes
just kammika-rebuild
# With bash
./sync.shjust kammika-rebuild reinstalls the local kammika package while allowing uv to reuse cached dependencies.
The sync tool detects which AI CLIs are installed on your machine and copies the prompts to each one. Unsupported or missing tools are skipped.
| Command | Description |
|---|---|
/kamma |
Plan, do, review, and finalize a thread in a single run |
/kamma:0-setup |
Scaffold a project with project.md, tech.md, workflow.md |
/kamma:1-plan |
Create a new thread (feature, bug fix, chore) with spec + plan |
/kamma:2-do |
Work through the selected thread until it is ready to review |
/kamma:3-review |
Review finished work, ideally in a fresh tool or session |
/kamma:4-finalize |
Finish a reviewed thread, update docs, and clean up |
/kamma:5-status |
Show where things stand across all threads |
/kamma:0-setup— initialize Kamma in your project/kamma:1-plan— create a thread spec and implementation plan/kamma:2-do— implement until ready for review/kamma:3-review— review, ideally in a fresh session or different tool/kamma:4-finalize— mark complete, update docs, clean up
/kamma runs the full cycle in a single session. It stops twice: to confirm the plan, and to ask you to test. If testing passes, it reviews and finalizes automatically.
Kamma is a Pāḷi word for action, work, doing.
Inspired by Conductor.