Overview

What is Kalami?

Kalami is a learning layer for Claude Code. It watches your coding sessions, captures mistakes and corrections, and turns them into rules that prevent the same issues from happening again.

It is a harness, not an agent. Kalami doesn't make decisions or write code. It observes, records, and delivers context — all through Claude Code's hook system. Zero AI in the critical path.

The Problem

AI coding assistants make the same mistakes repeatedly:

• You tell Claude "don't use any type" in session 3. And session 7. And session 12.
• Claude force-pushes to main because nothing stops it.
• Tests pass locally, but Claude never runs them before committing.
• Every new session starts from scratch — no memory of what went wrong before.

The Solution

You correct Claude → Kalami records it → Next session, it becomes a rule
                                         → Claude reads the rule
                                         → Mistake never happens again

One install. Automatic from that point forward.

With and Without Kalami

Scenario	Without Kalami	With Kalami
Same mistake, 5th time	You repeat the same correction	Kalami learned it on day 1
rm -rf on wrong directory	Command executes	Blocked by deny pattern
Broken code pushed	Tests weren't run	Verify chain blocks the push
New session	Claude starts from scratch	Claude reads all learned rules first
.env file accessed	Secrets exposed	Mechanically blocked

What Kalami Creates

After npx kalami, your project gets:

• Rules — learned from your corrections, delivered every session
• Hooks — 6 hooks that observe sessions and enforce quality
• Skills — 5 dev flow skills (commit, push, release, review, plan)
• Safety — 17 deny patterns blocking dangerous operations
• State — EXP tracking, session history, project profile

Everything lives in .kalami/ and .claude/. Fully reversible with npx kalami --uninstall.

Supported Projects

28+ frameworks, 10 languages — auto-detected, zero config:

Frameworks: Next.js, React, Vue, Nuxt, Svelte, SvelteKit, Angular, Remix, Astro, Gatsby, Vite, Express, Hono, Fastify, NestJS, Electron, Tauri, Expo, React Native, FastAPI, Django, Flask, Gin, Fiber, Actix, Rocket, Laravel, Rails, Flutter.

Languages: TypeScript, JavaScript, Python, Go, Rust, PHP, Ruby, Dart, Elixir, Swift.