Documentation Index Fetch the complete documentation index at: https://soulforge.proxysoul.com/llms.txt
Use this file to discover all available pages before exploring further.
Install brew tap proxysoul/tap && brew install soulforge
That’s it. macOS and Linux. Neovim and a Nerd Font are auto-installed on first launch.
Windows is not natively supported. Run SoulForge inside WSL for now. Progress tracked in issue #57 .
Prebuilt binary
Bun
Source
# download from https://github.com/ProxySoul/soulforge/releases/latest tar xzf soulforge- * .tar.gz && cd soulforge- * / && ./install.sh
Requires Bun >= 1.2. bun install -g @proxysoul/soulforge
git clone https://github.com/ProxySoul/soulforge.git cd soulforge && bun install && bun run dev
Add a key You need at least one LLM provider key. Pick one path:
One key, every model
Anthropic
OpenAI
Local (free)
GitHub Copilot
LLM Gateway — one key for Claude, GPT, Gemini, Grok, Llama, Qwen, and others. Up to 30% off frontier models.soulforge --set-key llmgateway sk-...
soulforge --set-key anthropic sk-ant-...
Get a key at console.anthropic.com . soulforge --set-key openai sk-...
Get a key at platform.openai.com . Run Ollama or LM Studio locally — no key needed. brew install ollama && ollama pull llama3.3
SoulForge auto-detects it on launch. Use your existing Copilot subscription. # after signing in via VS Code: soulforge --set-key copilot $( jq -r '.["github.com"].oauth_token' \ ~/.config/github-copilot/apps.json )
See Copilot setup for the full guide. Keys are stored in your OS keychain (macOS Keychain, Linux secret-tool). You can also export ANTHROPIC_API_KEY=... in your shell profile.
See all 20+ providers → Launch Press Ctrl+L to switch models. Type /help for commands.
Next: Quickstart Five minutes to your first refactor.
