gitwtfhub

wtf is codekeel?

habibicodech/codekeel — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

TL;DR

A TypeScript CLI that keeps a local decision ledger for Claude Code projects, so architectural rules are remembered and enforced automatically in every session.

Mindmap

mindmap
  root((codekeel))
    What it does
      Records architectural decisions
      Injects rules into new sessions
      Enforces decisions on edits
    Tech stack
      TypeScript
      Claude Code hooks
      Anthropic API optional
    Use cases
      Prevent AI coding sessions from contradicting past decisions
      Enforce team conventions automatically
      Review stale or conflicting rules
    Audience
      Developers
      AI coding tool users
      Engineering teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Record an architectural decision once and have every future Claude Code session automatically respect it.

REASON 2

Automatically check code edits against your project's conventions without writing custom lint rules.

REASON 3

Grant a temporary, time-limited exception when a rule is right in general but wrong for one specific edit.

REASON 4

Review decisions that codekeel noticed on its own from your codebase or conversation history.

What's in the stack?

TypeScriptNode.jsClaude CodeAnthropic API

How it stacks up

habibicodech/codekeel000madz000/payload-test-api-route-handlerakash-sr/memobsidian
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Runs fully locally with one npx command, an optional Anthropic API key unlocks live semantic checks.

AGPL-3.0 license: free to use and modify, but modified versions used over a network must also share their source code.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Walk me through running npx codekeel install to set up decision governance in my project.
Prompt 2
Explain how codekeel's four stages of capture, inject, enforce, and review work together.
Prompt 3
Help me record my first architectural decision using codekeel's /decision command.
Prompt 4
Show me how codekeel's temporary exception system works when a rule blocks a valid edit.

Frequently asked questions

wtf is codekeel?

A TypeScript CLI that keeps a local decision ledger for Claude Code projects, so architectural rules are remembered and enforced automatically in every session.

What language is codekeel written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Claude Code.

What license does codekeel use?

AGPL-3.0 license: free to use and modify, but modified versions used over a network must also share their source code.

How hard is codekeel to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codekeel for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.