Skip to main content
1

Launch

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.
3

Make a change

Describe the change in plain English.
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:

​
Essential shortcuts

​
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.