Install
brew tap proxysoul/tap && brew install soulforge# alternatives bun install -g @proxysoul/soulforge # or download a prebuilt binary from https://github.com/ProxySoul/soulforge/releases/latest
macOS, Linux, and Windows 10 1809+ / Windows 11 (x64). On Windows, grab soulforge-<version>-windows-x64.zip (portable) or soulforge-setup-<version>-x64.exe (setup wizard) from the latest release. ARM64 not yet supported (tracked upstream).
Quick start
soulforge --set-key anthropic sk-ant-...
cd your-project
soulforgeOther providers and OpenAI-compatible endpoints: docs/providers.
Benchmarks
Same model (Claude Opus 4.6), same codebase, same prompt.
Bug fix
| SoulForge | OpenCode | |
|---|---|---|
| Time | 6m 22s | 11m 18s |
| Cost | $1.70 | $3.52 |
| Result | Correct | Correct |
Audit task ("verify cost reporting is wired correctly")
| SoulForge | OpenCode | |
|---|---|---|
| Time | 2m 00s | 5m 56s |
| Cost | $0.84 | $2.61 |
| Accuracy | 7/7 (100%) | 4/7 (57%) |
| False alarms | 0 | 3 |
| Wrong claims | 0 | 1 |
Same bug. Same model. Same repo. Half the time. Half the cost.
Sources: recording 1 · recording 2 · recording 3
Features
| Feature | What it does |
|---|---|
| AST editing | TS/JS edits via ts-morph, 65+ ops, atomic batches. docs |
| Live Soul Map | SQLite graph, PageRank + git co-change, blast-radius tags. docs |
| LSP + Mason | 576+ servers installable from the TUI |
| 33 languages | symbol-level reads, not file dumps |
| Compound tools | rename_symbol, move_symbol, refactor, project (23 toolchains) |
| Task router | route each slot (spark / ember / compact / verify / web / semantic) to a different model per tab. Haiku for exploration, Sonnet for code, Flash for compaction. /router. docs |
| V2 compaction | usually 0 LLM tokens. docs |
| Parallel agents | Spark + Ember with shared I/O cache |
| Embedded Neovim | real nvim in a PTY, your config |
| 5 tabs | per-tab model, session, checkpoints, file claims |
| Time machine | every prompt is a checkpoint with a git tag. Ctrl+B / Ctrl+F rewinds and redoes both conversation and files on disk. /checkpoint undo <N>, /checkpoint save, per-tab |
| Sessions | auto-saved JSONL, crash-resilient, resumable by short-id prefix. Export to markdown / JSON / clipboard. Ctrl+P browser, multi-tab. docs |
| Memory | cross-session SQLite store of prefs, decisions, gotchas, context. Auto-recalled per turn from prompt + edited files. Project + global scopes, browser at /memory. docs |
| 21 providers | Anthropic, OpenAI, Google, Groq, DeepSeek, Bedrock, Ollama, LM Studio, ... + any OpenAI-compatible |
| Cost tracking | per-model + per-subagent USD, cache-aware |
| MCP + hooks | any MCP server, 13 events, drop-in .claude/settings.json |
| Headless mode | run from CI, scripts, pipelines. JSON / event stream, resumable sessions. docs |
| Hearth (exp) | remote control via Telegram or Discord, your host only |
| 36 themes | hot-reloaded JSON, Kitty inline images |
License
BSL 1.1. Free for personal and internal use. Commercial use: commercial license. Converts to Apache 2.0 on March 15, 2030.
Sponsors
Backed by
One API, 200+ models, up to 30% off frontier. Wired into SoulForge as the llmgateway provider.
Sponsor on GitHub (monthly or one-time) · PayPal (one-time) · All backers