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.

On startup, SoulForge scans your codebase and builds a graph — every file, symbol, and import edge. Then it ranks them so the most important stuff sits at the top of the system prompt. The agent never wastes a turn grepping for “where does auth live” — it already sees the map.

​
What you see

The map appears in every system prompt, looking like this: 
src/core/agents/agent-bus.ts (→12)
  +AgentBus  Shared coordination bus for parallel subagent communication
  +SharedCache
  • + — exported symbol
  • (→12) — blast radius: 12 files depend on this one
  • [NEW] — file changed recently
  • One-line summary after the name (when semantic summaries are on)

​
What makes it useful

  • Ranked by PageRank — files imported by lots of others rank higher.
  • Personalized per turn — files you just edited or read get boosted.
  • Git-aware — files that always change together get pulled in too.
  • Real-time — edits re-index immediately.
  • 30+ languages — TypeScript, Python, Rust, Go, Java, Ruby, C/C++, Swift, Kotlin, and more.

​
Config

Everything runs out of the box. If you want to tune it: 
{
  "repoMap": true,
  "semanticSummaries": "ast"
}
FieldValues
repoMaptrue (default) or false to disable
semanticSummaries"ast" (fast, default), "llm" (one-line LLM descriptions), "off"
/repo-map opens the settings panel.

​
Skip the scan

For quick one-shot questions, skip the startup scan: 
soulforge --headless --no-repomap "what's the version?"
Or set SOULFORGE_NO_REPOMAP=1.