Cranot

Cranot / roam-code

Public

Architectural intelligence layer for AI coding agents. Structural graph, architecture governance, multi-agent orchestration, vulnerability mapping. 139 commands, 101 MCP tools, 26 languages, 100% local.

cranot.github.ioroam-code ai-coding ai-tools architecture cli code-analysis
354
29
100% credibility
Found Feb 11, 2026 at 22 stars 16x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Roam is a command-line tool that indexes codebases to provide instant structural insights, dependency maps, and architecture analysis for developers and AI coding assistants.

How It Works

1
🔍 Discover Roam

You hear about a helpful tool that quickly maps out any codebase so you can understand it without reading every file.

2
📥 Get it ready

With one simple action, you bring Roam into your toolkit, ready to use anywhere.

3
📁 Open your project

Navigate to your codebase folder where all your files live.

4
🗺️ Create the map

Roam scans everything once and builds a smart overview of files, connections, and key parts – it takes just seconds.

5
🔎 Ask questions

Type everyday questions like 'what uses this function?' or 'show the project layout' to get clear answers.

6
🤖 Team up with AI

Share the insights with your AI helper so it understands the code perfectly from the start.

✅ Master your code

Now you see the big picture instantly – hotspots, risks, and structure – saving hours of confusion.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 22 to 354 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is roam-code?

Roam-code delivers instant codebase clarity via a Python CLI that indexes repos once for blazing queries on symbols, deps, call graphs, and architecture. Fire off `roam symbol Flask` for callers/callees/PageRank, or `roam context MyFunc` for AI-ready file ranges—skipping the grep slog. Supports Python/JS/TS/Java/Go/Rust/PHP/C++ with git signals like hotspots and ownership baked in.

Why is it gaining traction?

Unlike LSPs or Sourcegraph needing servers, roam-code runs shell commands yielding JSON/tables in 0.5s, slashing AI agent tool calls from 10+ to one. Commands like `roam health` flag cycles/god classes with utility-path smarts; `roam pr-risk` scores blast radius. Benchmarks crush on Laravel/Vue (9.5/10 accuracy), fueling github instant id for code rome workflows.

Who should use this?

AI coding agent wranglers on Cursor/Aider/Claude needing instant codebase clarity vs code extension hunts. Refactors spotting dead exports (`roam dead`) or splits (`roam split`). Onboarding devs tracing deps in monorepos without manual grep.

Verdict

Grab it for AI-heavy flows—docs shine, benchmarks prove quality, installs via pipx/uv. Low 16 stars/1.0% credibility flags early maturity; test on your repo before prod. Solid beta if github instant ngp speed hooks you.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.