habibicodech/codekeel

Codekeel is a tool that keeps track of the architectural decisions and conventions made while working with Claude Code, an AI coding assistant, so those decisions get remembered and enforced instead of quietly forgotten or contradicted in later sessions. Its core idea is a decision ledger, a plain YAML file living in your project, that records things like "we always use this pattern" or "never do that", and then makes sure future coding sessions actually follow those rules. The tool works in four stages. First, you capture a decision, either by typing it yourself with a slash command or by accepting one that codekeel noticed on its own. Second, every active decision automatically loads into context at the start of each new session. Third, the tool enforces those decisions, checking simple pattern based rules for free on every edit, and, if you provide an Anthropic API key, checking more judgment based rules against a live model too. Fourth, any contradictions or decisions that seem to have gone stale get flagged for a human to review, rather than the tool silently guessing what to do. Installing codekeel is a single command, npx codekeel install, which sets up the needed hooks and a slash command inside Claude Code's own configuration, and creates a starter ledger for the current project if one does not already exist. Everything runs entirely on your own machine, with no account, no server, and no telemetry sent anywhere. If you do add your own Anthropic API key, you unlock extra features like live semantic checking of edits against decisions, detecting decisions mentioned in conversation that were never explicitly recorded, and a one time grouping of your codebase into higher level features. The project also includes a system for temporary exceptions, so a rule that is right in general can still be waved through for one specific edit, with that exception automatically expiring after a few hours and every meaningful exception logged for audit. Codekeel is written in TypeScript and released under the AGPL-3.0 license.