Stop coding in the dark.
Ground your agents in compiler truth.
Frontier AI coding agents (Claude Code, Cursor, Windsurf) fail on complex codebases due to context bloat, broken call sites, and architectural boundary drift. Phanuel compiles polyglot codebases into a deterministic 2ms SQLite AST graph, serving token-budgeted context envelopes, pre-flight shadow mutation sandboxes, and pre-merge CI/CD invariant firewalls over the Model Context Protocol (MCP).
curl -fsSL https://raw.githubusercontent.com/warmpondwater/phanuel/main/install.sh | sh
-
❌
Context Budget Exhaustion: Dumps 30,000–80,000 raw tokens into prompt context, causing lost-in-the-middle attention degradation.
-
❌
Blind Mutations: Edits physical files on disk, discovering broken call sites and syntax errors only after compilation breaks.
-
❌
Architectural Drift: Silently introduces cyclic imports, leaks low-level drivers into domain layers, and erodes module boundaries.
-
❌
Temporal Blindness: Erases recent git hotfixes because raw textual source code has zero temporal commit awareness.
-
✅
Topological Architecture Maps: High-level topological system maps deliver orientation in <400 tokens; body-stripped skeletons in <800 tokens.
-
✅
Shadow AST Mutation Sandboxes: Agents dry-run patches in memory before touching physical files, verifying types and call sites in 2ms.
-
✅
Architectural Invariant Firewalls: Tarjan SCC cycle detection and package boundary barriers intercept regressions before merge.
-
✅
Git Temporal Awareness: Maps commit churn and hotfix frequency directly to AST symbols, preventing accidental patch reversions.
Engineered for Autonomous Agents
Phanuel provides an in-process, thread-safe compiler substrate that elevates AI coders from textual guessers to deterministic engineers.
Topological Architecture Map
Generates high-level topological architecture maps in under 400 tokens, orienting AI agents without blowing context budgets.
2ms SQLite AST Knowledge Graph
Tree-sitter AST parser across 11 languages (Go, TS, Python, Rust, C/C++). Zero embeddings, zero stochastic hallucinations.
Shadow AST Mutation Sandbox
Allows AI agents to dry-run AST patches in memory before touching physical files, catching syntax and type breaks immediately.
CI/CD Pre-Merge Invariant Firewall
Enforces declarative package boundaries, prevents circular dependency cycles, and intercepts regressions before pull request merge.
PageRank Anchors & Polymorphism
Pinpoints architectural keystones via Brandes betweenness and resolves structural interface implementations with sub-millisecond precision.
Zero Egress Air-Gapped Shield
0% telemetry egress. Runs 100% on local hardware silicon. Safe for classified, defense, and proprietary enterprise codebases.
Single Unified Binary. Instant Activation.
Phanuel Core is 100% free and open-source. Commercial Pro and Fleet tiers via Creem are coming soon.
- Unlimited AST Indexing & SQLite DB
- 11 Polyglot Languages Supported
- Model Context Protocol (MCP) Server
- Topological Architecture Maps (<400 tokens)
- Continuous Live Watcher Daemon
- Apache License 2.0
- Everything in Core, plus:
- Shadow AST Mutation Sandbox
- Architectural Invariant Firewall
- Pre-Merge CI/CD Gatekeeper
- Semantic AST Diffing & Rollback
- Zombie Dead Code Quarantine
- Cryptographic Audit Certification
- All Commercial Pro Features
- 10 Floating Silicon Device Seats
- CI/CD Pipeline Volume Key Injection
- Centralized Slot Deactivation
- Priority MoR Technical Support
Everything You Need to Know
Does any code ever leave my machine?
Never. Phanuel operates under a strict 100% local loopback guarantee. Tree-Sitter parsing, graph analysis, and SQLite querying execute entirely in-process on your local CPU. 0% telemetry egress.
How do I upgrade to Pro or Fleet?
Phanuel uses a single unified binary. Commercial licenses will be available shortly on Creem. Once launched, run phanuel activate <KEY> to bind your machine, or export PHANUEL_LICENSE_KEY in CI/CD. No re-download required.
How does Phanuel connect to AI coding agents?
Phanuel implements the standard Model Context Protocol (MCP) over stdio. Simply run claude mcp add phanuel -- phanuel -mcp or configure your Cursor / Windsurf MCP JSON settings.
Does it work offline or in air-gapped enclaves?
Yes. Phanuel features zero external network dependencies and supports air-gapped cryptographic offline verification, making it fully compliant for classified, defense, and high-security finance environments.