Skip to content
MCP server

Codeledger

Local repo context bundles and evidence for AI coding agents before and after a task

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.10.82
Listing updated
today

Similar MCP servers

About Codeledger

Codeledger is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

CodeLedger scans a repository with deterministic local signals such as dependency structure, churn, tests, contracts and task keywords, then ranks and packs a bounded set of task-relevant files into a bundle at .codeledger/active-bundle.md. The agent reads that first, so it starts with the files most likely to matter. The same task on the same repo state gives the same ranking.

After the work, verification, receipts and session summaries show what changed and whether the selected context helped. Other features include scope contracts, loop detection, multi-agent conflict checks, session checkpoints and handoff commands. The README shows an example benchmark from a mid-sized Node.js service with fewer iterations and tokens, but cautions that results vary and offers a compare command to measure your own repo.

It works with Claude Code, Codex, Cursor, Copilot, Gemini CLI and others, and its MCP server (started with codeledger mcp start) is limited to supported feature tiers. Analysis runs locally and no account is needed for the CLI. The public wrapper is MIT, while the downloaded hardened runtime is under a separate Core License.

Install

Run in a terminal

claude mcp add codeledger -- npx -y @codeledger/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "codeledger": {
      "command": "npx",
      "args": [
        "-y",
        "@codeledger/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "codeledger": {
      "command": "npx",
      "args": [
        "-y",
        "@codeledger/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "codeledger": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codeledger/cli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "codeledger": {
      "command": "npx",
      "args": [
        "-y",
        "@codeledger/cli"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "codeledger": {
      "command": "npx",
      "args": [
        "-y",
        "@codeledger/cli"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Task context bundles
Selects a bounded, ranked set of files for a given task.
Deterministic ranking
Same task and repo state give the same selection.
Scope governance
Scope contracts, loop detection and conflict checks keep agents on task.
Verification receipts
Records what changed and whether the context was useful.
Session continuity
Checkpoints, summaries and handoff or recovery commands.
Local-first
Runtime analysis runs on your machine without source telemetry by default.

Good for

  • Giving an agent the right files before a bug fix
  • Comparing agent runs with and without curated context
  • Auditing what an agent changed
  • Handing a session over between agents
  • Reducing token use on a large repo

Pricing

Freemium

Local CLI needs no account; MCP server limited to supported feature tiers; MIT public parts plus separate core licence

Codeledger FAQ

Is an account required?

No account is needed for the local CLI flow.

Does it send my source code anywhere?

The README says runtime analysis is local and source code is not sent through telemetry by default.

How do I install it?

npm install -g @codeledger/cli, then run codeledger ready --task.

What is the licence?

The public wrapper and docs are MIT; the downloaded hardened binary uses a separate Core License.

Is the MCP server available to everyone?

The README says it is offered for supported feature tiers.

Is Codeledger free?

Codeledger has a free plan, with paid plans for more usage or features.

How do I add Codeledger to Claude Code?

Run this command in your terminal: claude mcp add codeledger -- npx -y @codeledger/cli

What are the best alternatives to Codeledger?

The closest alternatives to Codeledger are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers