Skip to main content

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.

1

Launch

cd your-project
soulforge
The first launch scans your codebase to build a live graph (a few seconds). Press Ctrl+L to pick a model.
2

Ask something

Type any question. The agent already knows your file layout.
> what does the auth middleware do?
3

Make a change

Describe the change in plain English.
> rename AgentBus to CoordinationBus across the project
Watch the agent run rename_symbol — one tool call updates every file.
4

Commit

Press Ctrl+G, then c. SoulForge writes the commit message and runs lint + typecheck before committing. Or just say:
> commit my changes

​
Essential shortcuts

KeyDoes
Ctrl+LSwitch model
Ctrl+EToggle editor panel (Neovim)
Ctrl+GGit menu
Ctrl+KCommand palette
Ctrl+B / Ctrl+FUndo / redo a turn (checkpoints)
Ctrl+XStop the agent
Ctrl+T / Ctrl+WNew tab / close tab

​
Common tasks

Rename & refactor

Rename a symbol across every file with one prompt.

Test, lint, commit

Run your toolchain through the agent.

Use multiple models

Cheap model for search, strong model for code.

Run from CI

Headless mode for scripts and pipelines.

Reach it from your phone [experimental]

Hearth — Telegram or Discord. (Experimental — expect rough edges.)

Connect MCP servers

GitHub, Sentry, anything MCP.

​
Next

  • Browse the recipes for copy-paste workflows.
  • Skim commands — type / to see them all in the app.
  • Tune ~/.soulforge/config.json — see configuration.