Menyediakan konteks repositori yang relevan dengan tugas dan bundle file berbasis bukti bagi AI coding agent untuk meningkatkan akurasi serta mengurangi penggunaan token.
Juga dikenal sebagai codeledgerECF/codeledger, @codeledger/cli
- Stars
- 8
- Tools
- —
- Unduhan, 30 hari
- 4.468
- Versi terbaru
- 0.10.82
- Commit terakhir
- 11 Nov 2026
- Lisensi
- —
Apa itu CodeLedger MCP?
CodeLedger adalah MCP server. Menyediakan konteks repositori yang relevan dengan tugas dan bundle file berbasis bukti bagi AI coding agent untuk meningkatkan akurasi serta mengurangi penggunaan token.
Ringkasan dibuat dari README proyek
Tentang CodeLedger MCP server
CodeLedger menyediakan kontrol konteks berbasis lokal (local-first) untuk AI coding agent guna meningkatkan akurasi dan mengurangi konsumsi token. Cara kerjanya adalah dengan memindai repositori untuk mencari sinyal seperti struktur dependency dan file test guna memilih kumpulan file terbatas yang relevan dengan tugas. Informasi ini ditulis ke dalam artifact spesifik di .codeledger/active-bundle.md, yang dapat dibaca oleh agent seperti Claude Code, Cursor, atau GitHub Copilot sebelum mulai bekerja.
Developer menggunakan CLI untuk menginisialisasi repositori dan bersiap untuk tugas tertentu menggunakan command ready. Tool ini menjalankan analisis secara lokal secara default dan tidak mengirimkan source code melalui telemetri. CodeLedger juga menyertakan MCP server yang dapat dijalankan melalui command line untuk integrasi dengan client yang kompatibel. User juga dapat menjalankan command compare untuk mengukur peningkatan performa pada metrik seperti penggunaan token dan tingkat kelulusan test.
Apa yang bisa Anda lakukan dengannya
- 1Menyiapkan konteks spesifik tugasAI agent dapat menerima bundle file terfokus yang relevan dengan perbaikan bug atau permintaan fitur tertentu.
- 2Memverifikasi perubahan agentUser dapat meninjau apa yang telah dimodifikasi oleh agent melalui ringkasan sesi dan receipt.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal CodeLedger MCP
Format diverifikasi 10 Nov 2026Instal CodeLedger MCP di Claude Code
$ claude mcp add codeledger -- npx -y @codeledger/cliInstal CodeLedger MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codeledger": {
"command": "npx",
"args": [
"-y",
"@codeledger/cli"
]
}
}
}Instal CodeLedger MCP di VS Code
.vscode/mcp.json
{
"servers": {
"codeledger": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codeledger/cli"
]
}
}
}Instal CodeLedger MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codeledger": {
"command": "npx",
"args": [
"-y",
"@codeledger/cli"
]
}
}
}Instal CodeLedger MCP di Codex
~/.codex/config.toml
[mcp_servers.codeledger] command = "npx" args = ["-y", "@codeledger/cli"]
Instal CodeLedger MCP di Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"codeledger": {
"command": "npx",
"args": [
"-y",
"@codeledger/cli"
]
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaucodeledgerecf/codeledger is public and reachablegithub.com/codeledgerecf/codeledger ↗Lolos
- Paket menyebut repo ini sebagai sumbernya@codeledger/cli names github:codeledgerECF/codeledger as its sourcenpmjs.com/package/@codeledger/cli ↗Temuan
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-11github.com/codeledgerecf/codeledger ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @codeledger/cliLolos
- Tidak ada advisory kritis di paket maupun dependensinya1 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote menjawab handshake MCPTidak diperiksa
README
Lihat di GitHubCodeLedger
Give AI coding agents the right repo context before they start - then verify what changed.
CodeLedger is local-first context control for AI coding agents. It scans a repository, selects a bounded task-relevant set of files, and writes an evidence-backed context bundle before the agent begins work.
Works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and other CLI or MCP-compatible coding agents.
Try It
npm install -g @codeledger/cli
cd your-project
codeledger ready --task "Fix null handling in user service"
CodeLedger initializes the repo if needed, refreshes the index, and creates the
task-specific bundle at .codeledger/active-bundle.md. Your agent reads that
artifact first so it starts with the files most relevant to the task.
Runtime analysis is local by default. Installing or updating may fetch packages or release artifacts from npm and GitHub Releases; CodeLedger runtime analysis does not send your source code through CodeLedger telemetry by default.
Example Benchmark
Example result from a mid-sized Node.js service. Results vary by repository, task, agent, and scenario.
| Metric | Without CodeLedger | With CodeLedger | Change |
|---|---|---|---|
| Tests Passed | 78% | 94% | +16% |
| Iterations | 4 | 2 | -50% |
| Files Changed | 17 | 9 | -47% |
| Time to Finish | 6m 12s | 3m 40s | -41% |
| Token Usage | 28k | 18k | -36% |
Do not take the benchmark on faith - measure CodeLedger on your own repo:
codeledger compare \
--scenario .codeledger/harness/scenarios/auth-rate-limit.json \
--guided
If CodeLedger improves your coding-agent workflow, star the repo to follow releases and help other developers discover it.
Start Here
- Getting Started
- CLI Reference
- How It Works
- MCP Server
- Feature Tiers
- Security
- Contributing
- Latest Release
- npm package
How It Works
- CodeLedger scans the repo for deterministic local signals such as dependency structure, churn, tests, contracts, and task keywords.
- It ranks and packs a bounded set of task-relevant files.
- It writes
.codeledger/active-bundle.mdfor your coding agent. - After work, verification, receipts, and session summaries help show what changed and whether the selected context was useful.
Same task plus same repo state produces the same file ranking behavior.
Core Capabilities
- Give agents the right context: deterministic file selection, scope inference, bounded budgets, blast-radius hints, and co-change context.
- Keep work continuous: session summaries, checkpoints, mid-session refine, and handoff/recovery commands.
- Keep agents inside the task: scope contracts, intent governance, loop detection, and multi-agent conflict checks.
- Prove what happened: review intelligence, receipts, provenance, audit exports, and release evidence.
For the full command surface, see the CLI Reference.
Agent Integration
Claude Code can use CodeLedger hooks after codeledger ready initializes the
repo. Cursor, Codex, GitHub Copilot, Gemini CLI, Aider, Windsurf, and other
agents can read CLAUDE.md plus .codeledger/active-bundle.md, or use the
repo-local wrappers when available.
CodeLedger also includes an MCP server for supported tiers:
codeledger mcp start
codeledger mcp status
See MCP Server and Feature Tiers for setup and tier details.
Trust And Verification
- Runtime source analysis runs locally by default.
- Source code is not sent through CodeLedger telemetry by default.
- No account is required for the local CLI flow.
- Public releases include
SHA256SUMSand release-evidence artifacts. codeledger doctorchecks the local install, hooks, config, index, and ledger health.- The public wrapper, docs, harness, and scanning surface are inspectable in
this repo; the protected hardened runtime is covered by
LICENSE-CORE.
Install
npm install -g @codeledger/cli
codeledger --version
Or use the release zip:
- Download the latest release.
- Extract it.
- Run
install.sh.
The installer uses the bundled package from the zip, so the installed wrapper version matches the release. The wrapper then fetches the matching hardened binary from the GitHub release unless your environment already provides it.
Everyday Flow
cd your-project
codeledger ready
codeledger ready --task "Fix null handling in user service"
Inside an initialized repo, you can also use:
codeledger activate --task "Fix null handling in user service"
codeledger doctor
Browser, cloud, and sandboxed environments can use the repo-local runtime
deployed under .codeledger/bin/ after initialization or vendoring.
Architecture
CodeLedger has an open public surface and a protected hardened runtime:
PUBLIC: CLI wrapper, types, repo scanner, harness, reports, docs, hooks
PROTECTED: Scoring engine, selection algorithm, confidence internals
Use codeledger about, codeledger doctor, and command-specific --explain
output to inspect behavior and evidence without exposing protected
implementation internals.
Privacy
- Installation may use npm and GitHub Releases.
- Runtime analysis runs on your local machine by default.
- Runtime analysis makes zero source-code telemetry calls by default.
- Your source code is not required to leave your machine for the local CLI flow.
- Uninstall at any time.
License
- Public wrapper, types, repo scanning, harness, reports, docs, and examples: MIT
- Downloaded hardened binary: CodeLedger Core License
GitHub may classify the combined licensing structure as "Other" because the repo includes both MIT-covered public files and separately licensed protected runtime terms. Changing the license files should be a human legal decision.
Part Of ContextECF
CodeLedger applies Intelligent Context AI's context-control architecture to software engineering. For enterprise-wide governed context across applications and agents, see ContextECF.
CodeLedger is produced by Intelligent Context AI, Inc. See codeledger.dev.
Pertanyaan tentang CodeLedger MCP
Bagaimana cara menambahkan CodeLedger MCP ke Claude Code?
Jalankan claude mcp add codeledger -- npx -y @codeledger/cli di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan CodeLedger MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah CodeLedger mengirimkan source code saya ke server mereka?
Tidak, analisis runtime dilakukan secara lokal secara default dan tidak mengirimkan source code Anda melalui telemetri CodeLedger secara default.
AI coding agent mana saja yang kompatibel dengan CodeLedger?
CodeLedger bekerja dengan Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Aider, Windsurf, dan agent berbasis CLI atau MCP lainnya.
Bagaimana CodeLedger meningkatkan workflow coding?
CodeLedger membantu dengan memilih file yang relevan dengan tugas, yang dapat menghasilkan tingkat kelulusan test yang lebih tinggi, iterasi yang lebih sedikit, dan pengurangan penggunaan token.
Apakah saya perlu akun untuk menggunakan CLI lokal?
Tidak diperlukan akun untuk alur kerja CLI lokal.