Skip to main content

CLI Reference

Auto-generated

This page is auto-generated from kalami --help. Do not edit manually.

Commands​

npx kalami              Install kalami in the current project
npx kalami status       Show current rules, budget, and activity
npx kalami context      Show context budget breakdown
npx kalami doctor       Diagnose config issues (orphan paths, conflicts, etc.)
npx kalami doctor --fix Auto-fix what's fixable
npx kalami harden <p>   Upgrade prose rule to mechanical deny (100% enforcement)
npx kalami unharden <p> Remove a hardened deny rule
npx kalami profile      Show project identity and learned conventions
npx kalami debug        Print diagnostic info for bug reports
npx kalami allow <pat>  Remove safety deny patterns matching <pat>
npx kalami lessons      Display verified rules grouped by module
npx kalami --force      Reinstall (re-detects project, regenerates rule files)
npx kalami --uninstall  Remove all kalami files and restore original CLAUDE.md

Options​

--force, -f      Reinstall even if already installed
--no-refactor    Skip CLAUDE.md refactoring (install hooks + rules only)
--dry-run        Preview all changes without executing
--fix            Auto-fix issues found by doctor
--json           Output doctor results as JSON
--uninstall      Remove kalami from this project
--help, -h       Show this help
--version, -v    Show version

Detailed Reference​

npx kalami​

Install Kalami in the current project. Detects your stack, generates hooks, rules, skills, and safety defaults.

Flags: --force, --dry-run, --no-refactor, --uninstall

npx kalami status​

Show current rules, budget, safety, and session activity.

npx kalami context​

Show context budget breakdown — tokens used by rules, user instructions, and remaining capacity.

npx kalami doctor​

Diagnose configuration issues. Detects 11 issue types and returns a health score (0-100).

Flags: --fix, --json

npx kalami harden <recipe>​

Upgrade a prose rule to a mechanical deny (100% enforcement). 8 recipes: .env, npm, force-push, rm-rf, sudo, hard-reset, ssh, aws.

npx kalami unharden <recipe>​

Remove a hardened deny rule, reverting to prose-only enforcement.

npx kalami profile​

Show project identity, detected stack, learned conventions, and command configuration.

npx kalami debug​

Print diagnostic info for bug reports.

npx kalami allow <pattern>​

Remove safety deny patterns matching a substring.

npx kalami lessons​

Display all verified rules grouped by module.