# SoulForge

## Docs

- [Tabs](https://soulforge.proxysoul.com/agents/cross-tab.md): Multiple independent workspaces with tab-aware file claims.
- [Parallel agents](https://soulforge.proxysoul.com/agents/dispatch.md): Forge dispatches sub-agents in parallel for multi-file work.
- [Steering](https://soulforge.proxysoul.com/agents/steering.md): Redirect the agent mid-flight without aborting.
- [How it works](https://soulforge.proxysoul.com/concepts/architecture.md): A bird's-eye view of the SoulForge architecture.
- [Compound tools](https://soulforge.proxysoul.com/concepts/compound-tools.md): One call does the complete job — rename, move, refactor, test, commit.
- [Cost tracking](https://soulforge.proxysoul.com/concepts/cost-tracking.md): Live USD cost, per-model and per-subagent.
- [Code intelligence](https://soulforge.proxysoul.com/concepts/intelligence.md): LSP, AST, and fallbacks — the agent sees your code like an IDE.
- [The repo map](https://soulforge.proxysoul.com/concepts/repo-map.md): Why SoulForge starts every turn already knowing your codebase.
- [Context compaction](https://soulforge.proxysoul.com/context/compaction.md): What happens when the conversation gets long.
- [Modes & the prompt](https://soulforge.proxysoul.com/context/prompt-system.md): Switch personas with Ctrl+D. Load project instructions automatically.
- [Thinking & retries](https://soulforge.proxysoul.com/context/provider-options.md): Configure thinking modes, budgets, and retry behavior.
- [FAQ](https://soulforge.proxysoul.com/faq.md): Common questions, short answers.
- [Installation](https://soulforge.proxysoul.com/installation.md): Install SoulForge on macOS or Linux.
- [SoulForge](https://soulforge.proxysoul.com/introduction.md): Code-aware terminal AI that works with symbols, not strings.
- [GitHub Copilot](https://soulforge.proxysoul.com/providers/copilot.md): Use your Copilot subscription with SoulForge.
- [Custom providers](https://soulforge.proxysoul.com/providers/custom.md): Connect any OpenAI-compatible API with one block of config.
- [Providers](https://soulforge.proxysoul.com/providers/overview.md): 20+ built-in LLM providers, plus any OpenAI-compatible API.
- [Quickstart](https://soulforge.proxysoul.com/quickstart.md): Five minutes to your first refactor.
- [Run from CI or scripts](https://soulforge.proxysoul.com/recipes/headless.md): Headless mode — pipe in a prompt, get back results.
- [Plan before you code](https://soulforge.proxysoul.com/recipes/plan-mode.md): Research, plan, confirm, execute — for bigger refactors.
- [Rename & refactor](https://soulforge.proxysoul.com/recipes/rename-refactor.md): Change a symbol everywhere. Move files without breaking imports.
- [Use multiple models](https://soulforge.proxysoul.com/recipes/task-router.md): Cheap model for exploration, strong model for code. Cut cost without losing quality.
- [Test, lint, commit](https://soulforge.proxysoul.com/recipes/test-and-commit.md): Run your toolchain through the agent. Commit with a clean message.
- [Command reference](https://soulforge.proxysoul.com/reference/commands.md): 100 slash commands organized by category. Type / in chat or press Ctrl+K to open the command palette.
- [Configuration](https://soulforge.proxysoul.com/reference/configuration.md): Every setting, grouped by what you're trying to do.
- [AST editing](https://soulforge.proxysoul.com/tools/ast-edit.md): The first AST-native AI editor. Edits by symbol, not string.
- [Checkpoints](https://soulforge.proxysoul.com/tools/checkpoints.md): Git-backed undo/redo for agent actions. Browse, rewind, and branch from any point in the conversation.
- [Editor & Neovim](https://soulforge.proxysoul.com/tools/editor.md): Embedded Neovim with your config, plugins, and LSP — plus 18 editor tool actions for the AI agent.
- [Hearth — Remote control [experimental]](https://soulforge.proxysoul.com/tools/hearth.md): Reach your SoulForge from Telegram or Discord. (Experimental — expect rough edges.)
- [Hooks](https://soulforge.proxysoul.com/tools/hooks.md): Run shell commands on agent events. Claude Code compatible.
- [LSP servers](https://soulforge.proxysoul.com/tools/lsp.md): Install, manage, and inspect LSP servers from the TUI.
- [MCP Servers](https://soulforge.proxysoul.com/tools/mcp.md): Connect to Model Context Protocol servers for external tool integration. Supports stdio, HTTP, and SSE transports.
- [Project tool](https://soulforge.proxysoul.com/tools/project.md): Auto-detected project commands across 23 ecosystems with pre-commit enforcement and monorepo discovery.
- [Sessions](https://soulforge.proxysoul.com/tools/sessions.md): Save, resume, export, and branch conversations.
- [Skills](https://soulforge.proxysoul.com/tools/skills.md): Installable agent capabilities, browsable from the TUI.
- [Floating Terminals](https://soulforge.proxysoul.com/tools/terminals.md): Spawn, resize, and manage terminal sessions alongside the chat.
- [Themes](https://soulforge.proxysoul.com/tools/themes.md): 24 builtin themes, custom themes with hot reload — pick your flavor or add yours.
- [Troubleshooting](https://soulforge.proxysoul.com/troubleshooting.md): Fixes for common issues.

## OpenAPI Specs

- [openapi](https://soulforge.proxysoul.com/api-reference/openapi.json)

## Optional

- [GitHub](https://github.com/proxysoul/soulforge)
- [Blog](https://proxysoul.com/blog/soulforge)