roam-code

Overview

Roam-code is a comprehensive local codebase intelligence solution that parses repositories into a SQLite-backed graph, providing 238 commands and 224 MCP tools across 28 languages. It offers features like code context retrieval, change safety analysis, algorithmic risk review, and dry/shape detection. The server helps AI agents understand codebase structure, identify potential issues before changes, and maintain code quality through automated analysis.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• understand

  Get a full briefing of the codebase

  Try:What does this codebase do?Try:Give me a high-level overview of the repository
• context

  Get files to read with exact line ranges for a given symbol

  Try:Show me files related to AuthServiceTry:Get the context for the PaymentProcessor class
• retrieve

  Get graph-aware spans for free-form natural language tasks

  Try:Find all authentication related codeTry:Get code related to payment processing
• preflight

  Check blast radius + tests + complexity before making changes

  Try:What will break if I modify UserService?Try:Show me tests affected by changes to DatabaseClient
• critique

  Verify a patch for clones not edited and hot paths

  Try:Review my code changes for potential issuesTry:Check if my changes broke any clones
• health

  Get a composite health score (0-100) for the codebase

  Try:How healthy is this codebase?Try:What are the main issues with the code quality?
• diff

  Show blast radius of uncommitted changes

  Try:What will be affected by my uncommitted changes?Try:Show me the impact of my current changes
• stale-refs

  Find dangling links, hrefs, and broken anchors across the repo

  Try:Find all broken links in my documentationTry:Show me all files with stale references
• math

  Detect code that is correct but computationally expensive

  Try:Find performance issues in my codeTry:Check for N+1 query patterns
• smells

  Find code duplication and structural issues

  Try:Find duplicated code patternsTry:Show me code smells in the repository
• pr-analyze

  Analyze pull requests for completeness and correctness

  Try:Review this pull request for issuesTry:Check if my PR covers all affected code
• impact

  Determine the impact of changing a specific symbol

  Try:What will be affected if I change the User model?Try:Show me all callers of this function

Comparable tools

Installation

pip install roam-code
cd your-repo/
roam understand

{
  "mcpServers": {
    "roam": {
      "command": "roam",
      "args": ["mcp"]
    }
  }
}

FAQ

What makes roam-code different from other code analysis tools?

Roam-code creates a comprehensive graph of the codebase including symbols, dependencies, call graphs, architecture layers, and git history, providing structural context that goes beyond simple pattern matching.

How does roam-code ensure change safety?

Through features like preflight checks, impact analysis, affected test identification, and diff critique capabilities that help understand what would be affected by code changes.

Compare roam-code with