CR

cranot/roam-code

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

517 stars 50 forks Качество 76 Тренд 40Apache-2.0

Локальный сервер интеллекта кодовой базы CLI + MCP для агентов кодирования ИИ: граф кода SQLite, 28 языков, 287 команд, 246 инструментов MCP, элементы безопасности изменений, доказательства аудита, нуль ключей API.

Обзор

Без учетных данных · 100% локальный по умолчанию (opt-in metrics-push — единственная исходящая поверхность) · Пакеты ChangeEvidence с проверкой вскрытия · Apache 2.0 · полностью работает на вашем компьютере 279 команд · 244 MCP-инструмента (16 в стандартном базовом пресете) · 28 языков METR и FrontierCode оба указывают на один и тот же пробел: прохождение тестов — это не то же самое, что код, который может быть объединён. Roam — это система, которая предоставляет агенту локальные факты графа до редактирования, блокирует рискованные изменения и выпускает данные с ограниченной областью после запуска. В инструментах агент/обзора, опрошенных по состоянию на 12 июня 2026 года, отличим является следующая комбинация: - Нет учетной записи, нет ключа API, нет входа в облако. Установка и запуск PIP. - Исходный код никогда не покидает машину; Air-gapped репозитории работают как облачные репозитории. Единственная исходящая поверхность (roam metrics-push) — opt-in, только сводка, и печатает точную полезную нагрузку под ---dry-run.

Обзор (машинный перевод)

Локальный анализ кода и готовые к запуску проверки для программистов.

Roam даёт вашему агенту повторно используемый индекс кода, находки шаблонов, кандидата Алгоритмические альтернативы и проверяет, что он может вызывать по мере работы. Он может исследовать кодировать и оценивать изменения, не строя каждый анализ с нуля.

Запускается на вашем компьютере · бесплатный и открытый исходный код · нет учетной записи или ключа API для локального анализа · нет автоматической загрузки исходного кода или телеметрии

288 команд · 259 инструментов MCP (17 в стандартном пресете [core) · 28 языков

Свяжитесь с вашим агентом · Попробуйте выполнить задание · Документация · Изучите карту кода

Почему Roam отличается

Ваш агент уже может читать код, обдумывать его и запускать инструменты. Роум-добавляет Многоразовые локальные анализы: запросы индексируемых соединений между файлами и функциями, Проверьте обнаруженный шаблон с предложенной альтернативой или проведите проверку с областью применения. Результаты дают вашему агенту конкретный материал для осмотра, тестирования и развития.

Статические проверки используют локальные вычисления, а не вызовы моделей или платный API-роум. Ваш Использование модели агентом, включая чтение этих результатов, отдельно. Обновить индекс с roam index при изменении кода.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

roam-code

Local code analysis and ready-to-run checks for coding agents.

Roam gives your agent a reusable codebase index, pattern findings, candidate algorithmic alternatives, and checks it can call as it works. It can investigate code and evaluate changes without building each analysis from scratch.

Runs on your machine · free and open source · no account or API key for local analysis · no automatic source-code or telemetry upload

288 commands · 259 MCP tools (17 in the default core preset) · 28 languages

Connect your agent · Try a task · Documentation · Explore the code map

Why Roam is different

Your agent can read code, reason about it, and run tools already. Roam adds reusable local analyses: query indexed connections between files and functions, inspect a detected pattern with a proposed alternative, or run a scoped check. The results give your agent something concrete to inspect, test, and build on.

Static checks use local compute, not model calls or a paid Roam API. Your agent’s model usage, including reading those results, is separate. Refresh the index with roam index as the code changes.

Roam is useful before there is a defect or a patch: trace a dependency, compare an approach, or establish which checks a change will need. Agents use the tools; people set direction and decide what ships. It complements your editor, search, tests, security tools, and code review.

Connect your agent

You need Python 3.10+ and a Git repository. On Linux, macOS, or Windows:

pip install "roam-code[mcp]"
cd path/to/your/repo
roam init

Replace the path with your project. init builds the local index and creates project configuration; use roam index if you want only the index. The first run can download a parser and takes longer than a refresh.

Then choose your agent’s setup guide. Connect through MCP (a standard way for agents to use tools), or let your agent call the CLI. Add the usage instructions to its project configuration; connecting

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →