Graph-powered terminal-native multi-agent coding assistant with codebase-aware intelligence, AST-native editing, and zero-cost context compaction for large-scale codebases.
SoulForge is a terminal-native AI coding assistant designed for large-scale codebases, distinguished by graph-driven code awareness and AST-level precise editing.
Graph Engine (Soul Map) parses projects into a real-time graph of files, symbols, and import edges using SQLite at startup. Combined with PageRank and git co-change ranking, it dynamically renders system prompts with blast-radius labels per conversation turn, enabling the agent to understand cascading edit impacts.
Precise Code Operations support reading individual functions/classes by symbol name across 33+ languages, with an intelligent fallback chain: LSP → ts-morph → tree-sitter → regex (including Mason installer managing 576+ LSP servers). For TypeScript/JavaScript, 65+ AST-native edit operations address symbols by name with zero text matching—changing a return type costs only ~5 tokens. rename_symbol provides cross-file safe renaming via LSP rename + zero dangling reference verification, while move_symbol auto-updates all imports in TS/JS, Python, and Rust.
Multi-Agent Collaboration dispatches parallel sub-agents (explore, code, web-search, etc.) with shared file read caches to eliminate redundant reads. Task Router allows assigning different models to slots (spark/ember/webSearch/desloppify/verify/compact/semantic).
Zero-Cost Context Compaction (V2 Compaction) continuously tracks structured state during conversations (touched files, decisions, failures, tool results). When context fills up, it serializes directly with typically 0 LLM token consumption. Benchmarked: 34 messages compressed to ~7.5k prompt tokens (4% utilization).
Terminal Experience built on React 19 + OpenTUI for terminal UI, with an embedded real Neovim instance (running in PTY with full user config/plugins/LSP). The Tab system supports 5 independent sessions per project with cross-tab file declaration visibility and Git hard-block conflict prevention. Every prompt auto-creates a checkpoint with branch-and-restore from any point.
Extensibility includes Claude Code Hooks compatibility (13 lifecycle events), MCP protocol support, and a Skills system for community domain skill installation. The Hearth module enables remote control via Telegram/Discord with tap-to-approve for destructive ops and automatic secret sanitization. Supports 21+ LLM providers and any OpenAI-compatible API. Runtime is Bun-based, covering macOS and Linux (Windows requires WSL).
Installation: Homebrew (recommended): brew tap proxysoul/tap && brew install soulforge; precompiled binaries from GitHub Releases; Bun global install: bun install -g @proxysoul/soulforge. Prerequisites: Bun >= 1.2 (except precompiled binary), Neovim >= 0.11 (auto-installable), at least one LLM API key.