Kalami

AI keeps making the same mistakes. Kalami makes it stop.

You correct Claude once. Kalami records it. Next session, that mistake becomes a rule — Claude reads it before writing a single line. No more repeating yourself.

npx kalami

One command. Under 0.5 seconds. Detects your project, installs everything.

How It Works

 Session 1          Session 2          Session 3
 ─────────          ─────────          ─────────
 AI makes      ──→  Kalami turns  ──→  AI reads rules
 mistake             mistake into       before coding
                     a rule
 You correct   ──→  Rule added    ──→  Mistake never
 the AI              to memory          happens again

Kalami is a harness, not an agent. It observes Claude Code sessions through hooks, learns from three signals, and delivers rules at the start of every session:

• Your corrections — "no, do it this way" (highest quality)
• Error-fix pairs — command fails, AI fixes, command passes
• AI self-recorded — AI voluntarily records a lesson

Rules that prove useful float to the top. Stale rules fade out. Contradicted rules are excluded immediately.

What You Get

Learning that compounds — Every session makes the next one better. EXP milestones track progress from "getting to know your project" to "deep project expertise."

17 safety defaults — .env files, rm -rf, force-push, sudo, ~/.ssh — all blocked mechanically before they execute. Opt out with npx kalami allow <pattern>. Upgrade any rule to 100% enforcement with npx kalami harden.

Verify chain — Auto-detects your typecheck, lint, test, and build commands. Blocks commits and pushes that fail any check.

5 dev flow skills — commit, push, release, review, plan. Tell Claude what you want — skills handle the workflow with verification built in.

28+ frameworks, 10 languages — Next.js, React, Vue, FastAPI, Django, Gin, Rails, and more. Auto-detected, zero config.

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 --force      Reinstall (re-detects project, regenerates rule files)
npx kalami --uninstall  Remove all kalami files and restore original CLAUDE.md

Documentation

Full docs at kalamiai.github.io/kalami — concepts, guides, CLI reference, troubleshooting.

Requirements

• Node.js 22+
• Git

License

MIT