Soulforge

The agent that treats code as code

Every other AI coding tool treats your codebase as text. It greps, it pastes 500-line files into context, it builds oldString/newString blobs and prays the whitespace matches. Half the turn is orientation. The other half is string-matching roulette.

SoulForge treats code as code. On startup it parses your project into a live Soul Map — every file, symbol, import edge — ranked by PageRank and git co-change. Forge opens every turn oriented: it reads single symbols by name (not whole files), edits TS/JS through the AST (symbol kind + name, 65+ ops, zero text matching), and rewrites the rest with line-anchored edits that never drift.

What that means in practice:

• ast_edit changes a return type with value: "Promise<User>" — no oldString, no whitespace failures, no line-offset math.
• Reads pull one function by name, not an 800-line dump. Context stays lean.
• V2 compaction serializes structured state as the conversation happens — when context fills, it compacts for free.
• Sub-agents share a read cache, so 3 parallel explorers don't re-open the same file 3 times.

Same work, a fraction of the tokens, a fraction of the seconds.

Not your average CLI

• Steering — type while the agent works, messages inject mid-stream. More
• Lock-in mode — hide narration, show only tool activity and final answer
• Inline images — pixel-perfect images and animated GIFs via Kitty graphics protocol
• 24 themes — Catppuccin, Dracula, Gruvbox, Nord, Tokyo Night, Rose Pine, and more. Hot-reload custom themes. More
• Floating terminals — Ghostty-powered PTYs next to the chat
• Plan mode — research, write a structured plan, you approve, then execute. More
• Memory — persistent SQLite memory across sessions, scoped per project or global
• Pre-commit enforcement — git commit auto-runs lint + typecheck; fails block the commit
• 100 slash commands — full reference

Install

brew tap proxysoul/tap && brew install soulforge

macOS and Linux. Neovim and a Nerd Font auto-install on first launch.

Windows: not natively supported. Use WSL for now. Tracked in #57.

# Bun (global)
bun install -g @proxysoul/soulforge

# Prebuilt binary
# download from https://github.com/ProxySoul/soulforge/releases/latest
tar xzf soulforge-*.tar.gz && cd soulforge-*/ && ./install.sh

# Source
git clone https://github.com/ProxySoul/soulforge.git && cd soulforge && bun install && bun run dev

Get a key

Pick any one.

soulforge --set-key llmgateway sk-...         # one key for every major model, up to 30% off frontier
soulforge --set-key anthropic sk-ant-...      # or any individual provider you already have
soulforge                                     # launch, Ctrl+L to pick a model

All providers · Custom providers

How it compares

Verified April 2026. Report inaccuracies.

Real numbers

All from SoulForge's own codebase, on Claude Sonnet 4.6:

Claude Code's Explore subagent averages ~$0.70 per 5-minute research run with Haiku. SoulForge matches it when you route spark to Haiku via the task router — with the added benefit of full repo-map context.

Try it

brew tap proxysoul/tap && brew install soulforge
cd your-project
soulforge

Then:

> rename AgentBus to CoordinationBus across the project
> run tests and commit

Pair a Telegram/Discord bot once with /hearth pair, then keep chatting from your phone — the session auto-syncs both ways.

Full docs at soulforge.proxysoul.com.

License

Business Source License 1.1. Free for personal and internal use. Commercial use requires a commercial license. Converts to Apache 2.0 on March 15, 2030.