soulforge

Name: soulforge
Author: proxysoul

Verified

AI coding agent that edits symbols, not strings. AST surgery, full LSP, and a live code graph wired to memory that resurfaces by file, co-change, and semantics. https://soulforge.proxysoul.com/

835stars

63forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/proxysoul/soulforge

Getting Started

Guides for using ai agents skills like soulforge.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/10/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@jimp/core: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/diff: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-bmp: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-gif: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-jpeg: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-png: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/js-tiff: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-blur: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-color: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-contain: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-cover: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-crop: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-hash: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-print: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-resize: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-rotate: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/plugin-threshold: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@opentui/core: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@opentui/react: Vulnerability found",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "diff: jsdiff has a Denial of Service vulnerability in parsePatch and applyPatch",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "file-type: file-type affected by infinite loop in ASF parser on malformed input with zero-size sub-header",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "jimp: Vulnerability found",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-05-10T06:36:59.099Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is soulforge?

soulforge is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by proxysoul. AI coding agent that edits symbols, not strings. AST surgery, full LSP, and a live code graph wired to memory that resurfaces by file, co-change, and semantics. https://soulforge.proxysoul.com/. It has 835 GitHub stars.

Is soulforge safe to use?

Yes. soulforge passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install soulforge?

Clone the repository with "git clone https://github.com/proxysoul/soulforge" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is soulforge written in?

soulforge is primarily written in TypeScript. It is open-source under proxysoul on GitHub, so you can review or fork the full source.

Are there alternatives to soulforge?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh soulforge against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

paper-craft-skills Molt-Pi-Maker

Empryo

previously SoulForge

Graph-powered code intelligence — multi-agent coding with codebase-aware AI.

Website · Download · Changelog · Discussions · Discord

SoulForge is now Empryo — the same symbol-level, graph-powered agent, rebuilt with a desktop app, a faster engine, and a composable core. Development continues on Empryo; this repository is its home for issues and discussions.

What is Empryo?

Empryo understands your codebase as a graph, not a pile of text. It parses your repo with tree-sitter, ranks symbols with PageRank and git co-change, and edits code at the symbol level — so it reads what matters and changes exactly what it means to.

It runs in a fast terminal UI, a native desktop app, and a scriptable headless mode. Free to use — bring your own provider key, or run fully local with Ollama. Your code never leaves your machine.


Live code graph	tree-sitter parse, PageRank + git co-change, blast-radius tags, FTS5 + trigram search
Symbol-level editing	AST edits via ts-morph (65+ ops, atomic batches) + structural edits across 30+ languages
Multi-agent	parallel explore/edit agents with a shared I/O cache
Task router	route each slot to a different model per tab — cheap to explore, strong to code
Time machine	every prompt is a checkpoint with a git tag; rewind and redo conversation and files
22 providers	Anthropic, OpenAI, Google, Groq, DeepSeek, Bedrock, Ollama, LM Studio … + any OpenAI-compatible
Desktop app	native window, embedded browser, and the full agent
LSP + MCP	576+ language servers via Mason, any MCP server, 13 lifecycle hooks

Runs on macOS, Linux, and Windows.

Install

# macOS / Linux
curl -fsSL https://empryo.com/install.sh | bash

# Windows (PowerShell)
irm https://empryo.com/install.ps1 | iex

brew install proxysoul/tap/empryo
winget install ProxySoul.Empryo

Desktop app and prebuilt binaries: empryo.com/download.

empryo --set-key anthropic sk-ant-...   # or run local with Ollama, no key
cd your-project
empryo

Benchmarks

Same models, same repo, same tasks — Empryo's graph does more with less.

	Empryo	Pi
Bugs fixed	8 / 9	7 / 9
Cost	$1.13	$1.58
Wall-clock	4m 16s	10m 0s
Input tokens	1.09M	6.21M

Empryo navigates by symbols and call hierarchies instead of grep-and-read, so it takes fewer steps and burns fewer tokens. Full methodology and transcripts: empryo.com/benchmarks · reproduce it at proxysoul/pi-vs-empryo-bench.

SoulForge

SoulForge remains available to download and install, and we'll keep fixing bugs and critical issues. New features and active development move to Empryo.

brew tap proxysoul/tap && brew install soulforge
# or
bun install -g @proxysoul/soulforge

This repository

Issues and Discussions — the home for Empryo bug reports, questions, and ideas.
The SoulForge source stays archived here under its existing license (see LICENSE).