codeledger — Claude Code MCP server: repo context on demand
Scans a repository, picks the files a task needs and writes a context bundle your agent reads before it starts.
claude mcp add codeledger -- npx -y @codeledger/cliWhat codeledger does
CodeLedger handles context selection for coding agents, and it runs locally. It walks the repo, weighs signals such as dependency structure, churn, tests and task keywords, then ranks files and packs a bounded set into .codeledger/active-bundle.md. That artifact is what the agent opens first. Feed it the same task against the same repo state and you get the same ranking.
Once the work is done, receipts and session summaries show what changed and whether the chosen context helped. Checkpoints, mid-session refinement and handoff commands keep a long session from falling apart. Source analysis stays on your machine by default, and the local CLI flow needs no account. Installing or updating may pull packages from npm and artifacts from GitHub Releases.
Node.js is required, since the CLI installs globally through npm. The wrapper, scanner, reports and hooks are MIT-licensed; the hardened runtime with the scoring engine and selection algorithm ships under LICENSE-CORE.
What it helps with
- pick the files a task needs before the agent starts
- record what an agent changed during a session
- resume work from a checkpoint after a session drops
- check whether the selected context actually helped
- spot conflicts when several agents touch one repo
Example prompts for the agent
- Run
codeledger ready --task "Fix null handling in user service"and start from the bundle - Check the install with
codeledger doctor - Bring up the MCP server:
codeledger mcp start
How to install codeledger
Platform CLI
claude mcp add codeledger -- npx -y @codeledger/cliPlatform CLI
codex mcp add codeledger -- npx -y @codeledger/cliConfig file
{
"mcpServers": {
"codeledger": {
"command": "npx",
"args": [
"-y",
"@codeledger/cli"
]
}
}
}Config file
{
"servers": {
"codeledger": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codeledger/cli"
]
}
}
}Platform CLI
gemini mcp add codeledger npx -y @codeledger/cliStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about codeledger
How do I install codeledger in Claude Code?
Add the MCP server with claude mcp add codeledger -- npx -y @codeledger/cli. The CLI itself installs separately: npm install -g @codeledger/cli.
What does codeledger do?
It scans the repo, selects task-relevant files and writes a bundle to .codeledger/active-bundle.md. Your agent reads that first, and receipts plus session summaries follow the work.
Does my source code leave my machine?
Runtime analysis runs locally by default and no source-code telemetry is sent. Installation and updates reach out to npm and GitHub Releases.
