Graphicle — граф кода и память проекта для агентов
Graphicle
Граф кода и память проекта в одной программе на Rust: агент получает выдержки из файлов со ссылкой на строки
- 432 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Setup правит конфигурацию агентов, добавляет хуки Git и включает запись сессий в проекте
- Индекс включает код, документы и разговоры с агентом, а при включенных ответах выдержки уходят выбранному провайдеру модели
Установка
- Работает в
Ручная установка
brew install graphicle-ai/tap/graphicle && graphicle setupКоманда setup запускается в корне репозитория и подключает найденных агентов. Основные команды: graphicle ask, graphicle graph, graphicle graph affected, graphicle open, graphicle doctor, graphicle disconnect, graphicle config set model.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Setup правит конфигурацию агентов, добавляет хуки Git и включает запись сессий в проекте
- Индекс включает код, документы и разговоры с агентом, а при включенных ответах выдержки уходят выбранному провайдеру модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Graphicle разбирает репозиторий через tree-sitter, без модели, и строит граф кода из файлов, функций и классов с их вызовами и импортами. Рядом он хранит документы проекта (Markdown, PDF, файлы Office, HTML), принятые решения и прошлые сессии Claude Code и Codex. Агент спрашивает через MCP и получает выдержки с указанием файла и строк в пределах заданного бюджета токенов. Команда graphicle setup индексирует репозиторий и подключает найденных агентов по MCP. Она же включает запись сессий, добавляет в AGENTS.md раздел из двух строк и ставит Git-хуки, которые обновляют индекс после коммита, слияния и переключения ветки. Перед каждым ответом Graphicle заново читает файлы, измененные с прошлого раза, а graphicle disconnect откатывает все, что сделал setup. Команда graphicle ask отвечает на вопрос по коду, а graphicle graph ищет по графу и показывает, что зависит от символа. graphicle open открывает граф и память в браузере, graphicle doctor проверяет установку. Воспоминания, которые предлагает агент, ждут вашего одобрения в этом веб-приложении.
Для кого. Для разработчиков, у которых Claude Code, Codex или Cursor тратят много шагов на поиск нужного места в большом репозитории.
Подходит, если
- Агент долго ищет, где в проекте повторяются неудачные запросы, и нужны выдержки со ссылкой на файл и строки
- Перед правкой функции надо узнать, что от нее зависит: помогает graphicle graph affected
- Хочется, чтобы новая сессия начиналась с одобренных заметок и последних реплик прошлой
- Документы проекта в PDF и Office должны искаться вместе с кодом
- Репозиториев несколько, и память нужна общая для рабочего пространства
Не подходит, если
- Репозиторий маленький, и агент находит нужное обычным поиском: экономию токенов автор не обещает
- Нельзя менять файлы конфигурации агентов: setup правит .mcp.json, настройки Codex, Cursor и VS Code
- Нужна подпись и проверка сборки под Windows: версия для Windows пока в предварительном состоянии и без подписи
- Вам нужны очень длинные сессии с накопленной памятью: такие сценарии автор еще не проверял
Пример запроса к агенту
Используй graphicle и найди, где в проекте повторяются неудачные запросы, покажи файлы и строки.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Сборка для Windows с архитектурой x86-64 предварительная и не подписана. Setup меняет конфигурацию найденных клиентов и хуки Git, поэтому список измененных файлов стоит просмотреть сразу после установки.
Graphicle работает локально, без аккаунта и телеметрии, а в сеть сам ходит только раз в день, чтобы проверить новую версию. Ответ текстом требует выбрать модель командой graphicle config set model, и тогда выдержки уходят выбранному провайдеру: Anthropic, OpenAI или локальной Ollama.
В замерах автора Graphicle находит код не хуже обычного поиска, экономию токенов автор не заявляет. Доступность релизов и сайта проекта из России не проверена.
Как отключить. Выполните graphicle disconnect: команда убирает добавленные записи из конфигурации клиентов и хуки, а копии с суффиксом .graphicle-bak остаются.
Частые вопросы
Как поставить Graphicle для Claude Code?
Выполните brew install graphicle-ai/tap/graphicle, затем graphicle setup в корне репозитория. Для Claude Code запись попадает в .mcp.json проекта, хуки записи сессий — в .claude/settings.local.json.
Какие агенты подключаются автоматически?
Setup находит Claude Code, Codex, Cursor, VS Code и Claude Desktop и подключает их по MCP. Любому другому MCP-клиенту подходит короткая запись в JSON, пример есть в документации по MCP.
Отправляет ли Graphicle код наружу?
Нет, пока вы сами этого не попросите. Граф и память лежат в одном файле SQLite на вашем компьютере, а инструменты MCP модель не вызывают.
Чем Graphicle отличается от связки Graphify и сервера памяти?
Он объединяет граф кода, память и MCP в одной установке с одним файлом хранилища. У связки из двух инструментов нужны отдельная настройка каждого агента и два MCP-сервера.
Как отключить проверку обновлений?
Задайте переменную окружения `GRAPHICLE_NO_UPDATE_NOTIFIER=1`. После этого Graphicle перестает сам обращаться в сеть.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
Скилл /graphify строит граф знаний по коду, документам и PDF проекта, чтобы агент отвечал запросами к графу, а не грепом
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Локальный граф структуры кода: строит карту репозитория через tree-sitter и отдает агенту по MCP только тот контекст, который относится к правке
MCP-сервер и CLI, которые строят граф знаний по монорепозиторию и дают агенту запрашивать, понимать и править многоязычный код
Deep Graph MCP — граф кода репозитория для агента
Deep Graph MCP
MCP-сервер дает агенту граф кода репозитория: поиск функций по смыслу, связи символов и список мест, которые заденет правка
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Graphicle — граф кода и память проекта для агентов (эта запись) | нет | не нужна | 432 | |
| graphify | нет | 137 789 | только граф кода на Python, память подключается отдельным сервером | |
| code-review-graph | нет | не нужна | 32 463 | граф кода для проверки изменений, без общей памяти проекта |
| CodeGraph | нет | не нужна | 75 798 | граф кода для агента, без документов и памяти сессий |
Коротко о README
Документация открывается замерами скорости на 13 кодовых базах и точности поиска фактов, автор помечает их как результаты предварительных сборок. Отдельные разделы объясняют принцип работы в три шага и сравнивают установку с парой из графа кода и сервера памяти.