Carto

GitHub: divyekant/carto

What it does

Carto scans your codebase, builds a layered semantic index using LLMs, and stores it in Memories for fast retrieval. It produces skill files (CLAUDE.md, .cursorrules) that give AI coding assistants instant, structured context about your project — architecture, patterns, conventions, and cross-component wiring.

Key Features

• 5-phase indexing pipeline — Scan, Chunk+Atoms, History+Signals, Deep Analysis, Store
• 7-layer context graph — Map, Atoms, History, Signals, Wiring, Zones, Blueprint — each layer captures a different dimension of understanding
• Tree-sitter AST parsing — Language-aware chunking for Go, TypeScript, JavaScript, Python, Java, Rust (30+ languages detected)
• Two-tier LLM strategy — Fast tier (Haiku) for high-volume atom summaries, deep tier (Opus) for architectural analysis
• Tiered retrieval — mini (~5KB), standard (~50KB), or full (~500KB) context depending on task complexity
• Incremental indexing — SHA-256 manifest tracks file changes so subsequent runs only process what changed
• Skill file generation — Produces CLAUDE.md and .cursorrules with architecture, patterns, and conventions
• Module detection — Automatically identifies project boundaries from go.mod, package.json, Cargo.toml, pom.xml, pyproject.toml
• Built-in web dashboard — Browse indexed projects, explore modules, and query visually
• Natural language queries — Ask questions about your codebase and get answers from the index

How it fits

Carto is the intelligence layer that gives other tools deep understanding of a codebase. Hermes reads Carto’s index to generate audience-specific documentation. Delphi uses codebase context to generate better test scenarios. The skill files Carto produces are what make AI assistants immediately productive in a new codebase.

Quick Start

# Build
git clone https://github.com/divyekant/carto.git
cd carto/go
go build -o carto ./cmd/carto

# Configure
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# Index a codebase
carto index /path/to/your/project

# Query the index
carto query "How does authentication work?"

# Generate skill files
carto patterns /path/to/your/project --format all

Requires a running Memories server (default: http://localhost:8900).

Architecture

Carto is a Go binary with CGO (for Tree-sitter grammars). The CLI entry point uses Cobra commands. Internally, a pipeline orchestrator runs five phases sequentially: the scanner walks directories respecting .gitignore, the chunker uses Tree-sitter ASTs to split files at function/class boundaries, the atom extractor sends chunks to a fast-tier LLM for structured summaries, the deep analyzer uses a deep-tier LLM for cross-component wiring and architecture narratives, and finally everything is serialized to Memories with structured source tags enabling precise retrieval and cleanup.

A React SPA dashboard is embedded in the binary for visual browsing and querying.