roam-code

Local codebase intelligence CLI + MCP server for AI coding agents: SQLite code graph, 28 languages, 287 commands, 246 MCP tools, change-safety gates, audit evid

What is roam-code?

Local codebase intelligence CLI + MCP server for AI coding agents: SQLite code graph, 28 languages, 287 commands, 246 MCP tools, change-safety gates, audit evidence, zero API keys.

Overview of roam-code

What it is

roam-code is a local codebase intelligence CLI and MCP server for AI coding agents. It provides a reusable SQLite code graph, 288 commands (281 canonical + 7 aliases), 259 MCP tools (17 in the default core preset), and supports 28 languages. It runs on your machine, is free and open source, requires no account or API key for local analysis, and does not automatically upload source code or telemetry. It offers change-safety gates and audit evidence for code changes.

Key features

  • Reusable local analyses: query indexed connections between files and functions, inspect detected patterns with proposed alternatives, or run scoped checks.
  • Static checks use local compute, not model calls or a paid Roam API.
  • Refresh the index with roam index as the code changes.
  • 288 commands organised into 7 categories (Getting Started, Daily Workflow, Codebase Health, Architecture, Exploration, Reports & CI, Refactoring).
  • MCP server with 8 selectable presets (core, review, refactor, debug, architecture, compliance, compile-curated, full).
  • Core preset includes 17 tools: roam_alerts, roam_ask, roam_batch_search, roam_coupling, roam_dead_code, roam_deps, roam_diagnose_issue, roam_fetch_handle, roam_file_info, roam_grep, roam_metrics, roam_prepare_change, roam_search_symbol, roam_taint, roam_understand, roam_uses, and roam_expand_toolset.
  • No automatic source-code or telemetry upload; no account or API key required for local analysis.

Use cases

  • Find where to start: get an overview of the project, definitions, and indexed connections.
  • Evaluate an approach: inspect pattern findings with alternatives from the algorithm catalog.
  • Check a change: run impact analysis, related-test guidance, and configured check results.
  • Trace a dependency, compare an approach, or establish which checks a change will need.
  • Useful before there is a defect or a patch: agents use the tools; people set direction and decide what ships.

Getting started

You need Python 3.10+ and a Git repository. On Linux, macOS, or Windows: bash pip install 'roam-code[mcp]' cd path/to/your/repo roam init 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. To inspect a first result yourself: bash roam health roam preflight Replace `` with a function or class in your project; find it with roam search .

License and pricing

Licensed under Apache-2.0. It is free and open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/cranotroam-code.svg)](https://yunodb.com/tools/cranotroam-code?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/cranotroam-code?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/cranotroam-code.svg" alt="Featured on YunoDB" height="20"></a>