Optave codegraph CLI
CLI строит граф зависимостей на уровне функций для 34 языков и отдает его агенту через MCP-сервер из 34 инструментов.
- 99 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Читает весь исходный код репозитория и пишет базу `.codegraph/graph.db` в проект.
- При подключении внешнего LLM-провайдера фрагменты кода уходят к нему.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/optave-codegraphОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает весь исходный код репозитория и пишет базу `.codegraph/graph.db` в проект.
- При подключении внешнего LLM-провайдера фрагменты кода уходят к нему.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
codegraph разбирает код через tree-sitter, складывает граф вызовов и импортов в SQLite и обновляет его инкрементально за доли секунды. Команда `codegraph mcp` запускает MCP-сервер: агент одним запросом узнает, кто вызывает функцию и что сломается при ее правке. Граф хранит роли символов (`entry`, `core`, `utility`, `adapter`, `dead`, `leaf`), метрики сложности, данные о совместных изменениях файлов из истории Git и дифф структуры между ветками. Сборка и запросы идут локально, без ключей и телеметрии.
Для кого. Командам с большими кодовыми базами, где Claude Code или Cursor правят функции, не зная всех вызывающих.
Подходит, если
- Агент собирается менять функцию, а ее вызывающие разбросаны по десяткам файлов.
- После рефакторинга нужно найти мертвые экспорты и циклические зависимости.
- Запросы на слияние проверяют командой `codegraph check --staged` с порогами радиуса влияния и сложности.
- Новый разработчик выясняет, что вызывает handleAuth, не читая весь репозиторий.
Не подходит, если
- Нужен поиск уязвимостей: анализ безопасности автор намеренно оставил вне проекта.
- Репозиторий небольшой, и агенту хватает `grep` и чтения файлов.
- В окружении нет Node.js 22.12 или новее.
Пример запроса к агенту
Покажи через codegraph, какие функции сломаются, если я изменю parseConfig, и отметь мертвые экспорты в `src`.Ограничения
Нужен Node.js 22.12 или новее. Граф лежит в `.codegraph/graph.db` внутри проекта и после правок требует `codegraph build` или режима `codegraph watch`. Анализ безопасности в проект не входит. Семантический поиск на эмбеддингах работает локально, но при подключении внешнего LLM-провайдера код уходит туда, куда вы его направите. MCP-сервер по умолчанию работает с одним репозиторием, несколько включают отдельно. Предрелизные архивы из GitHub Releases ставят из локального файла: установка по URL архива не проходит из-за платформенных зависимостей.
Как отключить. Уберите запись `codegraph mcp` из MCP-конфигурации и удалите глобальный пакет @optave/codegraph через npm. Каталог `.codegraph` в проекте удалите вручную.
Частые вопросы
Как подключить codegraph к Claude Code?
Соберите граф командой `codegraph build` и зарегистрируйте `codegraph mcp` как MCP-сервер в конфигурации клиента. Можно и без MCP: добавьте в CLAUDE.md порядок `codegraph where`, `codegraph context` и `codegraph fn-impact` перед правкой.
Отправляет ли codegraph код в сеть?
Нет. Сборка и запросы идут локально, без ключей, аккаунтов и телеметрии. Внешнего LLM-провайдера подключают по желанию, и тогда код уходит к нему.
Сколько инструментов у MCP-сервера?
Тридцать четыре. Они покрывают поиск символов, контекст функции, радиус влияния, цепочки вызовов, дифф между ветками и метрики сложности.
Как использовать codegraph в CI?
Команда `codegraph check` завершается с кодом 1, если нарушены пороги сложности, радиуса влияния, циклов или границ архитектуры. Правила описывает `manifesto`, а для диффа в запросе на слияние есть готовый сценарий GitHub Actions.
Какие языки поддерживает codegraph?
Тридцать четыре, среди них JavaScript и TypeScript, Python, Go, Rust, Java, C#, PHP, Ruby, C и C++, Kotlin, Swift и Scala. Все они собираются в один общий граф.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыГраф зависимостей кода для VS Code, консоли и MCP: импорты, вызовы, циклы, неиспользуемый код и влияние правок.
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Структурные вопросы о коде вместо перебора файлов: 38 языков, 42 инструмента, расширения для VS Code и JetBrains, режим для CI
CodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
MCP-сервер строит граф знаний о коде: поиск по смыслу, граф вызовов, трассировка HTTP-маршрутов и анализ влияния правок.
Локальный граф структуры кода: строит карту репозитория через tree-sitter и отдает агенту по MCP только тот контекст, который относится к правке
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Optave codegraph (эта карточка) | нет | 99 | ||
| code-graph-rag | нет | не нужна | 5 349 | строит граф знаний по монорепозиторию; Optave codegraph ведет граф вызовов по функциям с проверками для CI |
| codebase-memory-mcp | нет | не нужна | 48 531 | отвечает на структурные запросы агента; Optave codegraph добавляет метрики сложности, границы архитектуры и дифф между ветками |
Коротко о README
В графе лежат функции, вызовы, зависимости файлов, роли символов и метрики сложности. Поверх него работают 44 команды CLI, MCP-сервер и проверки для CI; граф экспортируется в DOT, Mermaid, GraphML и Neo4j CSV.