GrapeRoot CLI
Подбирает контекст для кодового агента по графу репозитория, учитывая прошлые чтения и правки файлов
- 1 048 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Установка меняет настройки MCP, инструкции и хуки проекта, а индекс и история чтений остаются на диске.
- Автообновление загрузчика и отправка отчетов об ошибках включены по умолчанию.
- Отобранный код получает провайдер модели, если подключенный агент использует облачный сервис.
Установка
- Работает в
Ручная установка
curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bashСкрипт автора для macOS и Linux. Перед запуском прочитайте его; после установки откройте новый терминал.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установка меняет настройки MCP, инструкции и хуки проекта, а индекс и история чтений остаются на диске.
- Автообновление загрузчика и отправка отчетов об ошибках включены по умолчанию.
- Отобранный код получает провайдер модели, если подключенный агент использует облачный сервис.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
GrapeRoot запускает кодового агента с контекстом проекта. Он сканирует репозиторий, связывает файлы с символами и перед каждым запросом подбирает фрагменты кода. Агент получает их вместе с вашей задачей. GrapeRoot учитывает, какие файлы агент уже читал или менял. Если контекста недостаточно, агент может запросить соседние узлы графа через MCP. Claude Code запускают командой `dgc`, Codex — командой `dg`; обе принимают путь к проекту. Вы задаете предел чтения одного файла и суммарный объем за ход. Так можно ограничить текст, который навигация добавляет к запросу. При необходимости агент может открыть дополнительные файлы.
Для кого. Для разработчиков, которые ведут длинные сессии с кодовым агентом и регулярно объясняют ему связи внутри большого проекта.
Подходит, если
- Агент начинает каждую задачу с поиска одних и тех же определений и импортов
- Разбор незнакомого проекта нужно продолжать в нескольких сессиях
- Перед изменением модуля требуется подобрать связанные участки кода
- Контекст большого проекта не помещается в отведенный бюджет чтения
Не подходит, если
- Вы хотите изучить или изменить исходники самого графового движка
- Задача касается одного небольшого файла и не требует индексации репозитория
- Нужно только вручную искать символы из уже настроенного языкового сервера
Пример запроса к агенту
Запусти Claude Code через GrapeRoot для этого проекта и подбери контекст, который нужен для изменения проверки прав пользователя.Ограничения
Нужны Python 3.10 или новее, Node.js 18 или новее и агент с настроенным доступом к модели. Установщик добавляет зависимости и меняет настройки MCP, инструкции и хуки проекта, поэтому проверьте созданные файлы перед работой. Автообновление загрузчика и отправка отчетов об ошибках включены по умолчанию; при необходимости отключите их до запуска на закрытом проекте. Индекс хранится локально, но при облачной модели отобранный код получает ее провайдер.
Как отключить. Вернитесь к обычной команде запуска своего агента. Удалите добавленное подключение `dual-graph` и связанные хуки после проверки настроек проекта. Каталоги `~/.dual-graph/` и `.dual-graph/` проекта содержат установку и индекс; сохраните нужный контекст перед их удалением.
Частые вопросы
Как установить GrapeRoot?
На macOS и Linux выполните команду установки из раздела ниже после чтения скрипта. Затем откройте новый терминал. Для Windows доступны PowerShell и Scoop.
Как запустить Claude Code или Codex с GrapeRoot?
Для Claude Code выполните `dgc /путь/к/проекту`, для Codex — `dg /путь/к/проекту`. Замените путь реальным каталогом. GrapeRoot подготовит граф и запустит MCP-сервер перед стартом агента.
Можно ли выбрать другой клиент?
Да. Команда `graperoot . --cursor` выбирает Cursor; доступны также Gemini CLI, OpenCode и GitHub Copilot. Точка обозначает текущий проект.
Как отключить телеметрию и автообновление?
Выполните `graperoot --no-telemetry` и `graperoot --no-auto-update`. Эти параметры отключают отправку отчетов об ошибках и автоматическую замену загрузчика.
Как ограничить объем чтения?
Задайте переменные окружения `DG_HARD_MAX_READ_CHARS` для одного файла и `DG_TURN_READ_BUDGET_CHARS` для одного хода. Это пределы количества символов; расход токенов также зависит от модели, кеширования и дополнительных чтений.
Открыт ли графовый движок?
Нет. Скрипты запуска имеют Apache-2.0, а движок пакета graperoot закрыт и распространяется на отдельных условиях.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыДвижок понимания кода для агентов: строит граф проекта и отдает по нему поиск символов, цепочки вызовов и зону влияния, экономя контекст
Локальный граф кода и контекст для агентов: сущности, связи Git и записанные ошибки отдаются через консоль, хуки и MCP
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
CLI и MCP-сервер строят граф кода репозитория и отвечают на вопрос агента ранжированным набором символов, одинаковым при повторе.
Индексирует кодовую базу в граф знаний и отдает агенту через MCP связи вызовов, радиус влияния правок и поиск по коду
Граф кода и память проекта в одной программе на Rust: агент получает выдержки из файлов со ссылкой на строки
Коротко о README
В папке проекта `.dual-graph/` файл `info_graph.json` хранит граф кода, а `chat_action_graph.json` — историю чтения и правок. Решения и задачи между сессиями сохраняет `context-store.json`.