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
soulforge

Other 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

Sponsor on GitHub (monthly or one-time) · PayPal (one-time) · All backers