An AI agent that refactors by AST surgery, not string patches
SoulForge exists to stop LLMs from mangling your code with text-level edits by making them operate on symbols via AST surgery and LSP.

What it does
SoulForge is a terminal-based AI coding agent that interacts with your codebase at the symbol level. It reads and edits abstract syntax trees directly—via ts-morph for TypeScript and JavaScript—rather than treating files as plain text. It maintains a live SQLite graph of your repository (the “Soul Map”) tracking PageRank, git co-change history, and blast radius, and pulls in over 576 LSP servers from its own interface. The result is a headless-capable, multi-tab agent that claims to refactor, rename, and move symbols with atomic precision across 33 languages.
The interesting bit
Where most agents treat a repo as a stack of text, SoulForge treats it as a queryable graph with a built-in time machine: every prompt becomes a git-tagged checkpoint, and you can rewind both the chat history and the actual files when an edit goes sideways. It even embeds a real Neovim instance for when you need to take the wheel.
Key highlights
- Symbol-level edits via AST and LSP across 33 languages, avoiding whole-file dumps.
- Live SQLite “Soul Map” graph ranks symbols by PageRank and git co-change blast radius.
- Task router dispatches exploration, coding, and verification to different models in parallel tabs.
- Built-in time machine: every prompt is a git-tagged checkpoint that can rewind both conversation and disk state.
- Headless JSON/event-stream mode for CI, plus embedded Neovim in a PTY for manual fallback.
Caveats
- ARM64 builds are not yet available.
- Licensed under BSL 1.1: free for personal and internal use, but commercial deployment requires a paid license until 2030.
- Remote control via Telegram or Discord (
Hearth) is currently experimental.
Verdict
Try it if you manage large, multi-language repos and want atomic refactors with an undo button for reality; avoid it if you are on ARM64, need a fully open-source license today, or dislike terminal workflows.
Frequently asked
- What is proxysoul/Empryo?
- SoulForge exists to stop LLMs from mangling your code with text-level edits by making them operate on symbols via AST surgery and LSP.
- Is Empryo open source?
- Yes — proxysoul/Empryo is an open-source project tracked on heatdrop.
- What language is Empryo written in?
- proxysoul/Empryo is primarily written in TypeScript.
- How popular is Empryo?
- proxysoul/Empryo has 1.2k stars on GitHub and is currently cooling off.
- Where can I find Empryo?
- proxysoul/Empryo is on GitHub at https://github.com/proxysoul/Empryo.