AST-driven codebase intelligence for agentic workflows.

ForgeIndex is a local-first MCP server that provides structural code indexing, token compression, and dependency analysis to autonomous coding agents. It reduces per-session token usage by 90%+ compared to raw file reads.

• AST Parsing — Tree-sitter-based parsing for Python, TypeScript, JavaScript, Rust, Go, Java, C/C++, Ruby
• Token Compression — Skeleton views, TF-IDF ranking, and greedy knapsack packing reduce token payloads by 85–95%
• Dependency Graph — Import-based graph with PageRank scoring and blast radius analysis
• MCP Server — 14 tools exposed via JSON-RPC over stdio, compatible with Claude Desktop, Conductor, and any MCP client
• Auto-Reindexing — File watcher + git hooks keep the index fresh
• SQLite Store — WAL-mode database with xxh3 content hashing for JIT invalidation
• Zero Config — Works out of the box with sensible defaults

One line:

curl -fsSL https://raw.githubusercontent.com/chrismicah/forgeindex/main/install.sh | sh

From source:

cargo install --git https://github.com/chrismicah/forgeindex.git

From a local clone (replaces the global binary in ~/.cargo/bin):

git clone https://github.com/chrismicah/forgeindex.git
cd forgeindex
cargo install --path . --force

If you already have ForgeIndex installed globally and want to replace it with the current checkout, run:

cd /path/to/forgeindex
cargo install --path . --force

This updates the single forgeindex binary on your PATH, usually ~/.cargo/bin/forgeindex.

# Pull latest and reinstall
cd /path/to/forgeindex
git pull
cargo install --path . --force

# Then rebuild your project index
cd /path/to/your/project
forgeindex reindex

See Updating ForgeIndex for full details including when a clean rebuild is needed.

# Initialize in a project directory
cd /path/to/your/project
forgeindex init

# Check index status
forgeindex status

# Search for symbols
forgeindex query "UserService"

# Show codebase map
forgeindex map

# Start the MCP server
forgeindex serve

For Claude Code, add ForgeIndex to your user-level MCP config:

claude mcp add -s user forgeindex forgeindex serve

ForgeIndex uses the current working directory as the project root unless you pin a cwd in Claude's MCP config. The safest workflow is:

cd /path/to/your/project
forgeindex init
claude

For Claude Desktop, add it to claude_desktop_config.json:

{
  "mcpServers": {
    "forgeindex": {
      "command": "forgeindex",
      "args": ["serve", "--root", "/path/to/your/project"]
    }
  }
}

forgeindex init        Initialize index in current directory
forgeindex serve       Start MCP server (stdio)
forgeindex status      Show index statistics
forgeindex reindex     Re-index all files (or a specific path)
forgeindex query       Search for symbols
forgeindex map         Show codebase overview map
forgeindex hooks       Install/uninstall git hooks
forgeindex config      Show/init configuration

Configuration is stored in .forgeindex/config.toml:

[index]
languages = ["python", "typescript", "tsx", "javascript", "rust", "go", "java", "c", "cpp", "ruby"]
exclude_patterns = ["**/node_modules/**", "**/dist/**", "**/*.min.js"]
include_tests = false
max_file_size_kb = 512

[compression]
default_token_budget = 32000
skeleton_collapse_threshold_lines = 3
aggregate_imports = true
strip_comments = true

[watcher]
enabled = true
debounce_ms = 200
respect_gitignore = true

[git_hooks]
auto_install = true
hook_types = ["post-commit", "post-checkout"]

[server]
transport = "stdio"
log_level = "warn"

┌─────────────────────────────────────────┐
│     MCP Client (Claude Desktop, etc.)   │
└──────────────────┬──────────────────────┘
                   │ JSON-RPC (stdio)
┌──────────────────┴──────────────────────┐
│            FORGEINDEX                    │
│                                          │
│  ┌──────────┐ ┌───────────┐ ┌────────┐  │
│  │ Parser   │ │Compressor │ │ Graph  │  │
│  │(TS grammars)│(TF-IDF)  │ │(PageRank)│ │
│  └──────────┘ └───────────┘ └────────┘  │
│  ┌──────────────────────────────────┐    │
│  │  File Watcher + Git Hooks       │    │
│  └──────────────────────────────────┘    │
│  ┌──────────────────────────────────┐    │
│  │  SQLite Store (WAL mode)        │    │
│  └──────────────────────────────────┘    │
└──────────────────────────────────────────┘

Requires Rust 1.70+ and a C compiler (for tree-sitter grammars).

cargo build --release

The binary will be at target/release/forgeindex.

• Design Document — full architecture and specification
• MCP Tool Reference — complete tool docs for agent authors
• Updating ForgeIndex — how to reinstall the global binary and what to do after pulling MCP updates

MIT