codeledger — MCP-сервер для Claude Code: контекст репозитория
Сканирует репозиторий, отбирает файлы под конкретную задачу и кладёт готовый бандл контекста, с которого агент начинает работу.
claude mcp add codeledger -- npx -y @codeledger/cliЧто делает codeledger
CodeLedger — это локальный контроль контекста для ИИ-агентов. Он проходит по репозиторию, собирает сигналы вроде структуры зависимостей, истории изменений, тестов и ключевых слов задачи, ранжирует файлы и упаковывает ограниченный набор в .codeledger/active-bundle.md. Агент читает этот файл первым, поэтому стартует не с пустого места. Одинаковая задача на одинаковом состоянии репозитория даёт одинаковый порядок файлов.
После работы доступны проверка, receipts и сводки сессий: видно, что изменилось и пригодился ли выбранный контекст. Есть команды для чекпоинтов, уточнения задачи на ходу и передачи сессии. Анализ исходников по умолчанию идёт на вашей машине, аккаунт для локального CLI не нужен. Установка и обновления могут тянуть пакеты из npm и артефакты из GitHub Releases.
Ставить нужно Node.js: CLI ставится глобально через npm. Публичная часть — обёртка, сканер, отчёты и хуки — под MIT, а защищённое ядро со скорингом и алгоритмом отбора идёт отдельно по LICENSE-CORE.
Какие задачи решает
- выбрать файлы под конкретную задачу до старта агента
- зафиксировать, что именно изменил агент за сессию
- продолжить работу после обрыва сессии по чекпоинту
- проверить, был ли отобранный контекст полезен
- поймать конфликты, когда над репозиторием работают несколько агентов
Примеры запросов агенту
- Запусти
codeledger ready --task "Fix null handling in user service"и начни с бандла - Проверь состояние установки через
codeledger doctor - Подними MCP-сервер:
codeledger mcp start
Как установить codeledger
Командой платформы
claude mcp add codeledger -- npx -y @codeledger/cliКомандой платформы
codex mcp add codeledger -- npx -y @codeledger/cliФайл настроек
{
"mcpServers": {
"codeledger": {
"command": "npx",
"args": [
"-y",
"@codeledger/cli"
]
}
}
}Файл настроек
{
"servers": {
"codeledger": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codeledger/cli"
]
}
}
}Командой платформы
gemini mcp add codeledger npx -y @codeledger/cliПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о codeledger
Как установить codeledger в Claude Code?
Добавьте MCP-сервер командой claude mcp add codeledger -- npx -y @codeledger/cli. Сам CLI при этом ставится отдельно: npm install -g @codeledger/cli.
Что делает codeledger?
Сканирует репозиторий, отбирает файлы под задачу и пишет бандл в .codeledger/active-bundle.md. Агент читает его первым, а после работы остаются receipts и сводки сессий.
Уходит ли мой код куда-то наружу?
Анализ по умолчанию выполняется локально, телеметрия исходников не отправляется. Установка и обновления обращаются к npm и GitHub Releases.
