RepoRadar Octocode: семантическая аналитика кода для AI-помощников
Octocode — это инструмент для структурной семантической аналитики кода, который объединяет сервер MCP, граф знаний и семантический поиск в рамках одного бинарника на Rust. Проект адресуется разработчикам, которым нужно оснастить своих AI-помощников, таких как Claude или Cursor, возможностью глубже понимать и работать с кодовой базой.
Octocode решает проблему «слепоты» AI-ассистентов к коду: они не могут анализировать зависимости, осмысленно искать по файлам или запоминать контекст. Твой AI-помощник с помощью Octocode получит доступ к семантическому поиску, пониманию кода через граф знаний и навигационные возможности. Всё это поможет значительно упростить работу с большими проектами и улучшить взаимодействие с кодом.
Запускается Octocode как бинарный файл, что облегчает интеграцию в существующие процессы разработки. Проект еще на ранней стадии и актуален для Linux. С лицензией Apache 2.0 можно использовать в коммерческих проектах, но обязательно ознакомься с документацией для корректной настройки.
Проект Octocode от компании Muvon — это инструмент для улучшения взаимодействия искусственного интеллекта с кодовой базой. Он преобразует проект в структурированную графовую модель знаний, которую искусственные агентам, такие как Claude и Cursor, могут использовать для поиска, понимания и навигации по коду.
Зачем нужен Octocode?
Основная проблема, которую решает Octocode, заключается в том, что AI-ассистенты не могут эффективно работать с кодом: они не понимают его структуру, не могут запоминать контекст и не могут организованно искать в файлах. Octocode предлагает решения через:
- Семантический поиск: поиск кода на основе его значений, а не ключевых слов.
- Граф знаний: навигация по импортам, вызовам функций и зависимостям.
- Подписи кода: возможность видеть структуру без необходимости изучать весь файл.
- Точные команды LSP: быстрая навигация к определениям и поиск ссылок с помощью вашего языкового сервера.
Как установить и запустить
Установка Octocode достаточно проста и включает несколько этапов:
# Установщик для всех платформ (Linux, macOS, Windows)
curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/master/install.sh | sh
# Установка для macOS с Homebrew
brew install muvon/tap/octocode
Есть и другие методы установки, например, из crates.io или из исходного кода. Подробности можно найти в руководстве по установке.
После установки, необходимо настроить ключи API, если вы планируете использовать функции эмбеддинга или LLM:
# Пример настройки ключа API для эмбеддинга (по умолчанию используется локальный FastEmbed)
export VOYAGE_API_KEY="your-voyage-api-key"
Далее, индексируй свою кодовую базу с помощью команды:
cd /your/project
octocode index
И завершай настройку, добавляя Octocode в конфигурацию своего AI-ассистента.
Как это работает?
Octocode использует tree-sitter для разбора кода и создания графа узлов, который сохраняет связи между файлами, символами, импортами и вызовами:
Current Source → Tree-sitter AST → Live Symbol Graph ──────────────→ MCP `graphrag`
Графовая модель строится на лету, без необходимости индексирования или использования LLM, что делает работу быстрой и эффективной.
Ограничения и безопасность
Octocode имеет локальное хранение, что повышает уровень безопасности данных. Он не индексирует файлы, указанные в .gitignore, и работает в полностью локальной среде, без необходимости в облачных API, если этого не требуется. Система настроена таким образом, что ваши API-ключи хранятся локально и не передаются по сети.
Введение в функционал Octocode обеспечит AI-ассистенту доступ к пониманию структуры проекта, что сделает работу с кодом менее рутинной и более эффективной.
Открыть на GitHub: Muvon/octocode →