Skip to main content

Getting Started

Install​

npx kalami

That's it. Kalami detects your project (language, framework, package manager), installs hooks, rules, skills, and safety defaults. Under 0.5 seconds.

Verify​

npx kalami status

You should see your detected stack, session count (0), and safety status (17 deny patterns active).

Use​

Open Claude Code and start working. Kalami runs automatically in the background:

  1. Session starts — Kalami delivers any learned rules to Claude
  2. You work — Kalami tracks corrections, errors, and edits
  3. Session ends — Kalami generates a report card
  4. Next session — new rules from last session are active

No commands to run. No configuration to change. It just works.

What's next​

  • Overview — understand what Kalami does and why
  • Rules — how rules are created, ranked, and delivered
  • Safety Model — the three layers of protection
  • Skills — the 5 built-in dev flow skills

Options​

npx kalami --force        # Reinstall (re-detects project)
npx kalami --dry-run      # Preview changes without writing
npx kalami --no-refactor  # Skip CLAUDE.md changes
npx kalami --uninstall    # Remove everything, restore CLAUDE.md

Requirements​

  • Node.js 22+
  • Git