基于图引擎的终端原生多 Agent 编码助手，通过代码图谱感知、AST 原生编辑与零成本上下文压缩实现大规模代码库级别的精准 AI 编程。
SoulForge 是一个面向大规模代码库的终端原生 AI 编码助手，核心特色在于图驱动的代码感知能力与 AST 级精准编辑。
代码图谱引擎（Soul Map） 启动时基于 SQLite 图数据库将项目解析为文件、符号、导入边的实时图，结合 PageRank 与 git co-change 排名计算影响面，每轮对话动态渲染含 blast-radius 标签的系统提示，使 Agent 理解编辑的连锁影响。
精准代码操作 支持按符号名读取单个函数/类（33+ 语言），智能降级链为 LSP → ts-morph → tree-sitter → regex（含 Mason 安装器管理 576+ LSP server）。对 TypeScript/JavaScript 提供 65+ AST 原生编辑操作，按名称寻址、零文本匹配，更改返回类型仅需约 5 token。rename_symbol 通过 LSP rename + 零悬挂引用验证实现跨文件安全重命名，move_symbol 自动更新 TS/JS、Python、Rust 中的所有 import。
多 Agent 协作 支持派发 explore、code、web-search 等子 Agent 并行执行，文件读取缓存共享避免重复读取。Task Router 可为 spark/ember/webSearch/desloppify/verify/compact/semantic 等槽位分配不同模型。
零成本上下文压缩（V2 Compaction） 在对话过程中持续跟踪结构化状态，上下文填满时直接序列化，通常 0 LLM token 消耗。实测 34 条消息压缩后仅约 7.5k prompt token（利用率 4%）。
终端体验 基于 React 19 + OpenTUI 构建终端 UI，内嵌真实 Neovim 实例（PTY 运行，用户配置/插件/LSP 全部可用）。Tab 系统支持每项目 5 个独立会话，跨 tab 文件声明互可见且 Git hard-block 防冲突。每个 prompt 自动创建检查点，支持从任意点分支恢复。
扩展性 兼容 Claude Code Hooks（13 个生命周期事件）、MCP 协议，Skills 系统支持社区领域技能安装。Hearth 模块可通过 Telegram/Discord 远程控制，破坏性操作需人工审批并自动脱敏。支持 21+ LLM 供应商及任意 OpenAI 兼容 API，运行时基于 Bun，平台覆盖 macOS、Linux（Windows 需 WSL）。
安装方式： Homebrew（推荐）：brew tap proxysoul/tap && brew install soulforge；预编译二进制从 GitHub Releases 下载；Bun 全局安装：bun install -g @proxysoul/soulforge。前置依赖：Bun >= 1.2（预编译二进制除外）、Neovim >= 0.11（可自动安装）、至少一个 LLM API key。