⚡ BlastCode (blast)
Know what breaks before your agent edits.
An ultra-fast incremental code-graph engine, Model Context Protocol (MCP) server, and blast-radius analyzer for AI coding agents.
Features • Installation • Agent Integration • CLI Commands • Languages • Roadmap
⚡ Real-World Benchmarks & Live Demos
🖥️ Live Preview 1: Surgical Skeleton (Instead of reading whole files)
🖥️ Live Preview 2: The Caretaker Change Digest (Zero-Token Sync)
🖥️ Live Preview 3: Pre-Edit Blast Radius (Know what breaks before editing)
🚀 Installation & Zero-Install Running
Via npm / npx (Universal Zero-Install)
# Run stdio MCP server anywhere immediately:
npx blastcode serve
# Or install globally:
npm install -g blastcode
Via Python / PyPI / uvx
# Run stdio MCP server via uv:
uvx blastcode serve
# Or install via pip:
pip install blastcode
Via Cargo (Rust)
cargo install blastcode
Via Homebrew (macOS / Linux)
brew install isaim0011/tap/blastcode
Via Smithery / PulseMCP Registry
npx -y @smithery/cli install blastcode --client claude
Via VS Code / Cursor Extension
Install BlastCode from Open VSX or the VS Code Marketplace:
code --install-extension isaim0011.blastcode-vscode
# Or in Cursor:
cursor --install-extension isaim0011.blastcode-vscode
🤖 Agent Integration (MCP)
BlastCode works natively with any Model Context Protocol host (Claude Code, Cursor, Windsurf, Cline, Smithery).
Claude Code
claude mcp add blastcode -- npx blastcode serve --root .
Cursor / Windsurf / Claude Desktop (mcp.json)
{
"mcpServers": {
"blastcode": {
"command": "npx",
"args": ["-y", "blastcode", "serve", "--root", "/absolute/path/to/project"]
}
}
}
Instruct Your Agent (AGENTS.md / CLAUDE.md)
Add this instruction block so your AI agent uses BlastCode instead of brute-force reading files:
> Use the `blastcode` MCP tools before reading or modifying files:
> 1. `get_workspace_map`: Orient yourself across the project structure and exports.
> 2. `get_file_context` or `get_file_skeleton`: Use instead of opening and reading full files.
> 3. `get_symbol_source`: Retrieve the exact line range for a single function.
> 4. `trace_symbol`: Find all callers, callees, and type usages before refactoring.
> 5. `get_impact_radius`: Run with `new_source` BEFORE making an edit to verify what breaks.
> 6. `verify_patch`: Pre-flight validate proposed edit syntax and argument counts before writing to disk.
> 7. `get_affected_tests`: Find tests covering the changes and run the generated targeted test command.
> 8. `get_co_changed_files`: Discover implicit paired dependencies from git commit history.
> 9. `find_dead_code`: Detect unreferenced or orphaned symbols.
> 10. `grep_workspace`: Fast multi-threaded regex/token search across workspace files.
🛠️ MCP Tools Overview (14 Intelligent Capabilities)
💻 CLI Reference
You can also use blast directly from your terminal:
blast index # Build or refresh the index (.blastradius/index.db)
blast map # Print compact workspace map with exports
blast stats # View symbol, reference, and file counts
blast context src/lib.rs # Inspect skeleton, imports, dependents, and recent edits
blast skeleton src/lib.rs # View file skeleton
blast source my_function # Print source lines of a specific function
blast search "authenticate" # Fuzzy search symbols
blast trace verify_token # Trace callers, callees, and type usages
blast impact src/auth.py # Check blast radius of uncommitted changes
blast tests src/tools.rs # Find affected tests and targeted test command
blast verify src/auth.py # Pre-flight syntax and arity validation
blast coupled Cargo.toml # Find frequently co-committed files via Git
blast dead --limit 20 # Detect dead / unreferenced symbols
blast grep "pattern" # Ultra-fast multi-threaded workspace regex search
blast watch # Live terminal stream of AST-level changes
🌐 Supported Languages (16 Languages & Web Formats)
🗺️ Universal Ecosystem Roadmap
- v0.1.0: Core Rust engine, 10 languages, MCP server, CLI (
blast). - v0.2.0 & v0.2.1: Grep engine, patch verification, affected tests, struct fields & fuzzy normalization.
- v0.3.0: Frontend SFC & Web Template Engine (Svelte 5 runes, Vue 3, Astro, HTML, CSS/SCSS).
- crates.io: Official publication under
blastcode. - PyPI / uv:
pip install blastcode/uvx blastcode serve. - npm / npx:
npx blastcode serve. - Homebrew Tap:
brew install isaim0011/tap/blastcode. - Open VSX Registry:
isaim0011/blastcode-vscode. - VS Code / Cursor Extension: Embedded companion status and auto-launch.
📄 License
Licensed under the MIT License.