Roam Code

Content

Roam Code is a local-first codebase intelligence CLI and Model Context Protocol server for AI coding agents. It builds a SQLite-backed graph of a repository so Claude can ask for focused code context, pre-change safety checks, impact analysis, health signals, retrieval, review evidence, and audit-oriented metadata without relying on a cloud account.

The default MCP preset exposes the core tool surface for common coding-agent workflows. Additional presets are documented upstream for review, refactor, debugging, architecture, compliance, and full-tool scenarios.

Source Review

• https://github.com/Cranot/roam-code
• https://github.com/Cranot/roam-code/blob/main/README.md
• https://pypi.org/pypi/roam-code/json
• https://github.com/Cranot/roam-code/blob/main/pyproject.toml
• https://github.com/Cranot/roam-code/blob/main/server.json
• https://github.com/Cranot/roam-code/blob/main/src/roam/mcp_server.py
• https://github.com/Cranot/roam-code/blob/main/LICENSE

These sources were reviewed on 2026-06-06. Prefer the live repository, README, PyPI metadata, package metadata, MCP server manifest, MCP server source, and license file for current install commands, presets, tool counts, local-first behavior, write surfaces, and licensing.

Features

• Python package roam-code with optional MCP extra.
• Stdio MCP server launched with roam mcp.
• Local SQLite code graph built from an indexed repository.
• Core MCP preset for context, retrieval, preflight, impact, diff, PR risk, affected tests, health, diagnostics, critique, and related coding-agent tasks.
• Optional presets for review, refactor, debug, architecture, compliance, and full tool exposure.
• Local run ledgers, decision receipts, and ChangeEvidence-style audit artifacts documented in the repository.
• MCP mode and receipt controls documented for read-only and higher-authority agent workflows.
• Apache-2.0 license.

Installation

Install Roam Code with the MCP extra, index a repository, then configure the stdio MCP server:

pip install "roam-code[mcp]"
roam init

{
  "mcpServers": {
    "roam-code": {
      "command": "roam",
      "args": ["mcp"],
      "env": {
        "ROAM_MCP_PRESET": "core"
      }
    }
  }
}

After restarting the MCP client, ask Claude to use Roam Code for context, preflight, impact, or review checks before changing an indexed repository.

Use Cases

• Ask for graph-aware context before editing a symbol.
• Run preflight checks before a refactor.
• Estimate blast radius and affected tests for a planned change.
• Review an uncommitted diff against local code graph facts.
• Query health, complexity, dependencies, cycles, and code smells.
• Retrieve task-specific files and symbols without repeated raw search.
• Produce local audit evidence for agent-assisted code changes.

Safety and Privacy

Roam Code is powerful because it has local codebase visibility. It can read and index source files, derive graph facts, inspect git history, and write local artifacts under Roam Code-managed paths. Keep the MCP preset and agent mode as narrow as the workflow allows, and verify Roam Code findings with tests and human review before merging changes.

The README describes Roam Code as local by default with no API keys required. Even so, indexed code facts, generated reports, run ledgers, receipts, SARIF, and evidence bundles may contain sensitive repository details. Review those artifacts before sharing them, and avoid indexing private or regulated code in unapproved model workflows.

Duplicate Check

Existing MCP content includes code search, code review, repository, and developer-tool servers, but no dedicated entry for Cranot/roam-code or the roam-code PyPI package was found in content/mcp. This entry is distinct because it covers a local code graph and MCP server for preflight, retrieval, impact analysis, review evidence, and agent coding safety workflows.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationgithub.com
• Websiteroam-code.com
• Submitted by oktofeesh12026-06-06