Summary

SoulForge tackles the "blind start" problem of AI coding tools by building a live, graph-based dependency model of a codebase on startup. This immediate context awareness, powered by PageRank and Git history, enables faster, more accurate, and cost-effective AI-assisted development for engineers and power users.

How It Works

The core is the "Live Soul Map," an SQLite graph of files, symbols, imports, and exports, ranked by PageRank and enriched with Git co-change history. This provides instant codebase understanding and impact analysis. Code interaction uses "Surgical Reads," extracting only necessary symbols via a 4-tier parsing fallback (LSP, ts-morph, tree-sitter, regex) across 33 languages, reducing token usage and improving precision.

Quick Start & Requirements

Installation is streamlined via Homebrew (brew install soulforge) or Bun (bun install -g @proxysoul/soulforge) on macOS/Linux. Prebuilt binaries and source builds (requiring Bun >= 1.0, Neovim >= 0.11) are available. The self-contained bundle minimizes system dependencies. First launch assists with prerequisite installation. See GETTING_STARTED.md.

Highlighted Details

• Codebase Awareness: Real-time dependency graph with PageRank, blast radius, co-change history, clone detection, and FTS5 search.
• Multi-Agent & Multi-Tab: Parallel dispatch of specialized agents (code, search) with coordinated edits and concurrent session management.
• Extensive LLM Support: Integrates 19+ providers (Anthropic, OpenAI, Groq, Ollama, Copilot, etc.) and custom OpenAI-compatible endpoints.
• Task-Specific Models: Dynamic model selection via task router (e.g., Opus for planning, Haiku for cleanup).
• Embedded Neovim: Operates within the user's Neovim setup, preserving configuration and plugins.
• Inline Media Rendering: soul_vision tool displays images, GIFs, and videos in supported terminals.
• Code Execution: Sandboxed Python environment for running code.

Maintenance & Community

Developed by proxySoul, the roadmap focuses on extracting core intelligence into reusable libraries and enhancing features like monorepo support. Community channels (Discord/Slack) are not explicitly mentioned.

Licensing & Compatibility

Licensed under Business Source License 1.1 (BSL 1.1): free for personal/internal use, requires a commercial license otherwise. Converts to Apache 2.0 on March 15, 2030.

Limitations & Caveats

Inline media rendering via Kitty graphics protocol has compatibility issues with Kitty >= 0.38; older versions and Ghostty are supported. Commercial use requires a paid license. Primarily targets macOS and Linux.