Copied to clipboard!
ArchiMap v0.1.0
v0.1.0 Released • 100% Offline • Native AOT • Zero External Daemons

Stop Feeding Raw Text to Coding Agents. Give Them Architecture Intelligence.

An embedded, deterministic Code Graph Engine (Graph-RAG) for AI agents. Slashes LLM token bills by 90% and eliminates hallucinations using .NET 10 Native AOT, Kùzu DB, and Tree-sitter over MCP.

bash — terminal
$ curl -sSL https://raw.githubusercontent.com/mjasin/archimap/main/scripts/install.sh | bash
<15ms
Cold Start (Native AOT)
-97.0%
Token Bill Reduction
0 Tokens
Consumed During Indexing
129 MB
Embedded DB (GrandNode 2)

Core Engine Architecture

The Zero-Config Monolith

No Python runtimes, no Docker overhead, no Redis, no Neo4j, and no hosted cloud vector stores. Everything runs embedded in-process on bare metal.

.NET 10 Native AOT

Precompiled ahead-of-time into a single native binary. Starts in under 15ms with zero JIT compilation, zero dynamic reflection, and ultra-lean resident memory.

PublishAot=true <15ms latency

Embedded Kùzu Graph DB

Embedded C++ graph engine via direct P/Invoke bindings. Executes microsecond Cypher queries across topological edges (CALLS, IMPLEMENTS, CONTAINS) with zero external servers.

Embedded C++ Core 0 Sockets

Polyglot Tree-sitter AST

Deterministic C grammars queried via .scm S-expressions. Indexes C#, TypeScript, JavaScript, Python, PHP, and Markdown without sending any code to an external LLM.

Deterministic AST 0 API Tokens

Local ONNX 384D Vectors

Embedded INT8-quantized all-MiniLM-L6-v2 running locally on CPU. Accelerated with hardware SIMD (TensorPrimitives) for instant semantic symbol retrieval.

100% On-Device SIMD Accelerated

Model Context Protocol (MCP)

First-class JSON-RPC implementation over stdio using System.Text.Json source generation. Connects out-of-the-box with Claude Desktop, Cursor, Antigravity, Copilot, and Codex.

MCP Protocol JSON-RPC stdio

Continuous Post-Edit Sync

Incremental graph synchronization after every code edit or git commit. Enforces agent rules so your AI assistant never operates on stale architectural knowledge.

Incremental In-Process Git Hook Support
In-Process Runtime Architecture
Single Executable ~100MB
archimap (.NET 10 Native AOT Engine Monolith) 100% In-Process Memory • 0 External Daemons Tree-sitter AST Core Native C Grammar Walkers (.scm S-Expressions) C# TS / JS Python PHP ⚡ 0 API Tokens Consumed Embedded ONNX Runtime all-MiniLM-L6-v2 (INT8 Quantized Model) 384D Vector SIMD L2-Norm CPU Only 🔒 100% Offline AST Nodes & Relations 384D Embeddings Embedded Kùzu Graph Engine Native C++ Storage Driver (Zero TCP/IP Socket Overhead • In-Process P/Invoke) Code Topology Graph Edges: CALLS, IMPLEMENTS, CONTAINS, INJECTS In-Memory HNSW Index Cosine Similarity Index Instant 384D Top-K Vector Search Cypher Query Pipeline <5ms Traversal Latency Reverse Upstream Impact Traversals Pruned AST Skeletons & Blast Radius Model Context Protocol (MCP) Server JSON-RPC stdio Protocol • Source-Generated System.Text.Json (Native AOT) Claude Desktop Cursor MCP Antigravity (AGY) GitHub Copilot Codex / Windsurf

Efficiency & Precision

Plain Grep vs. ArchiMap Graph

Traditional AI coding agents read full 1,000+ line files into the prompt, burning tens of thousands of tokens and hallucinating on dead methods. ArchiMap delivers surgical structural slices.

Token Consumption per Typical Refactoring Task

AWS Bedrock: Claude Opus 4.8 ($5.00/1M) -97.0% Tokens
Traditional (File Dump / Grep) ~73,220 tokens ($0.3661 / task)
ArchiMap (Graph-RAG via MCP) ~2,180 tokens ($0.0109 / task) [-97.0%]
Capability & Behavior Vanilla Agent / Raw Grep ArchiMap Graph-RAG
Ingestion Scope Dumps entire files (1,200+ lines, hundreds of unrelated helper methods). Pinpoints entry point via 384D ONNX vector + 1-hop traversal in graph topology.
Token Cost / Round-Trip ~73,220 tokens ($0.366) per refactoring task. ~2,180 tokens ($0.011) (surgical AST slice).
Context Precision "Lost in the middle", hallucinates methods, confuses overloads. Strict deterministic pruned AST: LLM only inspects target slice.
Blast Radius Analysis Blind edits. Requires full build failures to find broken callers. Calculates upstream callers, implementors & affected tests in <5ms.
Team Monthly Bill (15 Devs) ~$4,393.20 / mo ~$130.80 / mo (Saves $4,262.40/mo, >850M tokens)

Enterprise ROI Projections (Amazon Bedrock)

Based on Claude Opus 4.8 benchmark pricing ($5.00 / 1M input tokens) across 40 daily agent prompts/dev

Up to 97.0% Monthly Savings
1 Developer
$292.88 / mo
$8.72 / mo
Save $284.16 / mo
5 Developers
$1,464.40 / mo
$43.60 / mo
Save $1,420.80 / mo
SWE TEAM
15 Developers
$4,393.20 / mo
$130.80 / mo
Save $4,262.40 / mo
50 Developers
$14,644.00 / mo
$436.00 / mo
Save $14,208.00 / mo

Model Context Protocol

Deterministic MCP Primitives

Exposed over JSON-RPC on standard input/output. Your agent invokes structured graph operations instead of grep scans.

archimap_locate

Semantic Entry Point Locator

Uses local 384D ONNX vectors + lexical BM25 matching to return precise symbol node IDs and source file paths.

locate("GetImpactAnalysis")
→ Symbol #4812 in Storage.cs:142
archimap_expand_context

AST Structural Skeleton

Traverses Kùzu DB graph relations (1-hop or n-hop) and returns method signatures and contracts with zero body bloat.

expand(symbol_id, depth: 1)
→ 380 tokens (vs 14,200 full file)
archimap_impact_analysis

Blast Radius & Test Traversal

Computes upstream callers, affected downstream implementors, and targets tests that need verification before edits.

impact("IGraphStorage", depth: 2)
→ 4 Callers, 2 Tests affected
archimap_inspect_body

Targeted Slice Inspection

Retrieves the exact implementation body only for the targeted symbol slice, with path traversal safeguards.

inspect(node_id)
→ Exact 35-line method slice
archimap_find_implementations

Interface & Base Traversals

Directly queries the Kùzu graph for all concrete types and classes satisfying an interface or abstract contract.

find_implementations("IGraphStorage")
→ KuzuGraphStorage in Storage/
archimap_find_implementation_pattern

Architectural Pattern Discovery

Discovers recurring architectural patterns (co-occurrence clusters, naming templates, base interfaces, DI registration).

patterns("RepositoryPattern")
→ DI wiring + companion tests
archimap_get_callers

Reverse Call Hierarchy

Queries upstream graph relationships (<-[:CALLS]-) to surface all symbols invoking a target method or constructor.

get_callers("ExecuteCypherQuery")
→ McpServer, QueryHandler
archimap_get_dependencies

Macro Topology & Packages

Queries project references, workspace packages (NuGet, npm, PyPI), and target frameworks without touching config files.

dependencies("ArchiMap.Core")
→ 3 Projects, 5 Packages
archimap_validate_pattern

Pattern Completeness Guard

Validates modifications against known patterns, detecting missing companion tests, DI bindings, or interface implementations.

validate_pattern(["UserHandler.cs"])
→ Warning: Missing UserHandlerTests.cs
archimap_sync

Incremental Graph Sync

In-process synchronization refreshing Kùzu DB graph with Git state after commits or bulk edits, without server restarts.

sync(rebuild: false)
→ 3 modified files indexed in 32ms
Verified Stress Test

GrandNode 2 Benchmark (.NET Monolith)

Stress-tested against GrandNode 2 — an enterprise open-source e-commerce solution with 57 projects, Clean Architecture, MediatR CQRS, and hundreds of domain models.

Zero API tokens used Multi-threaded Native AOT Roslyn Semantic Enrichment
Token Reduction
-94.8%
Across Full Test Suite
4,390
Source Files
57
Projects (.csproj)
14,650
Indexed Symbols
3,724
Roslyn Enriched
47,800+
Graph Edges
6m 12s
Full Ingestion (129MB)

Modern Quickstart Guide

Zero-Config Agent Integration

No manual JSON editing required. A single command detects your AI editor and wires the Model Context Protocol automatically.

1

Install Single Binary

Auto-detected

Fetches latest release (v0.1.0) directly to ~/.local/bin/archimap with companion tools.

$ curl -sSL https://raw.githubusercontent.com/mjasin/archimap/main/scripts/install.sh | bash

Ensure ~/.local/bin is in your $PATH.

2
0 API Tokens

Initialize & Index

Initializes local Kùzu DB storage and generates agent awareness files (.cursorrules, GEMINI.md, CLAUDE.md, AGENTS.md).

cd your-project && archimap init && archimap index .

Installs automatic Git post-commit graph sync hook.

3
Auto-Detect

Auto-Wire AI Agents

Automatically detects and configures all installed AI agents with a single CLI command.

archimap setup --all

Flags: --cursor, --claude, --antigravity, --copilot

CLI Output: archimap setup --all Real-time Auto-Detection
$ archimap setup --all
✔ Cursor MCP configured (.cursor/mcp.json)
✔ Claude Desktop configured (claude_desktop_config.json)
✔ Google Antigravity configured (.antigravity/mcp.json)
✔ GitHub Copilot / VS Code configured (.vscode/settings.json)
✔ Codex configured (codex.config.json)
🎉 Successfully configured 5 AI environments! Restart your editor to activate ArchiMap.

Manual MCP Configuration

Direct file schemas if you prefer manual configuration over archimap setup

.cursor/mcp.json