CLI
Run with npx @razcue/agent-kit <command>.
agent-kit init
Ask the setup questions and write the project (re-runnable).
agent-kit init [dir]
--name <kebab> --kind monorepo|site|existing|blank --stack none|nuxt-supabase|nuxt-content-site --apps web,app,docs
--level technical|non-technical --lang en|es --method sdd-tdd|sdd --commits conventional|none --git pr|trunk|read-only
--main <branch> --marketplace github:<owner/repo>|<local path> --yes (defaults, no prompts)
--supabase-mcp <project-ref> read-only Supabase MCP server in .mcp.json
--qa-checklist true|false --test-data true|false (Supabase only) --test-prefix TEST_ --test-data-dir supabase/test-data
agent-kit upgrade
New questions only + re-apply the agent layer + what's new.
agent-kit upgrade [dir] [--yes]
agent-kit propose
Send an improvement idea to the kit.
agent-kit propose "<title>" [--kind skill|hook|…] [--body …]
agent-kit uninstall
Remove what agent-kit added (backed up; your content stays).
agent-kit uninstall [dir] [--dry-run]
agent-kit setup
Make global knowledge writable on this machine.
agent-kit setup [--home <agent-kit clone>]
agent-kit doctor
Check a project's agent setup (--fix regenerates indexes and the board).
agent-kit doctor [dir] [--fix]
agent-kit knowledge
Knowledge base tools.
agent-kit knowledge <paths|find|index|check> ...
agent-kit scripts
Script registry.
agent-kit scripts <find|list|run|test|new|index|check> ...
agent-kit tdd
TDD status and related-test runs.
agent-kit tdd <status|run> ...
agent-kit work
Active work, board, scenario trace of a change.
agent-kit work <status|board|trace|new> ...
agent-kit specs
Living specs: notation lint, next id, merge a change, trace.
agent-kit specs <lint|next|merge|trace|list> ...
agent-kit qa
QA checklist from the living specs, QA runs, test-data fixture gaps.
agent-kit qa <sync|run|status|gaps> ...
agent-kit preflight
Pre-merge checklist (exit 1 = block).
agent-kit preflight [base]
agent-kit context
Tokens loaded every session + invisible skills.
agent-kit context [dir] [--budget N]
agent-kit usage
Usage signals for a retro.
agent-kit usage [--days N]
agent-kit commit
Conventional Commit helpers.
agent-kit commit draft [--staged] | check "<message>"