Empryo

Name: Empryo
Author: proxysoul

Warning

Empryo issue tracker + SoulForge (v2) archive — Empryo is the graph-powered AI coding agent that edits symbols, not strings: AST surgery, full LSP, a live code genome. Get it at https://empryo.com

887stars

69forks

TypeScript

Added 8/1/2026

View on GitHub Download ZIP Scan for vulnerabilities

Requires a passing catalog security scan. Resolve the flagged issues and resubmit to enable featuring.

AI Agentsaiai-agentsai-coding-agentclaude-codeclaude-code-alternativeclicode-intelligencecoding-agentcoding-assistantdeveloper-toolsempryographllmlspneovimopencodeterminaltree-sittertui

Installation

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

Getting Started

Guides for using ai agents skills like Empryo.

Security ReportWarning

Last scanned: 8/1/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@ai-sdk/amazon-bedrock: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/anthropic: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/deepseek: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/fireworks: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/gateway: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/google: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/groq: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/mcp: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/mistral: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/openai: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/openai-compatible: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/provider-utils: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@ai-sdk/xai: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "ai: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "linkify-it: linkify-it: Quadratic-complexity DoS via the `mailto:` validator scan-loop on attacker text",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "undici: Undici has an unbounded decompression chain in HTTP responses on Node.js Fetch API via Content-Encoding leads to resource exhaustion",
      "severity": "high"
    },
    {
      "file": "README.md",
      "line": 27,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://empryo.com/install.sh | bash\"",
      "severity": "low"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-08-01T06:28:22.022Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Empryo

previously SoulForge

The AI coding agent that edits symbols, not strings.

Empryo reads your repository as a living system: it sequences a genome — a live, ranked dependency graph of every symbol — and edits through the AST, never find-and-replace.

Website · Download · Benchmarks · 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. This repository is Empryo's public home for issues and discussions.

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

empryo --set-key anthropic sk-ant-...   # or run locally with Ollama — no key required
cd your-project
empryo

Desktop app and prebuilt binaries: empryo.com/download. Runs on macOS, Linux, and Windows.

Why Empryo

Most coding agents grep, read whole files, and patch strings — they never know what depends on the code they just changed. Empryo builds understanding before it mutates anything:

It maps before it reads. On launch, tree-sitter parses your repo into a live graph — every symbol, import, and call site, ranked by PageRank and git co-change. Graph queries answer in milliseconds and cost zero LLM tokens.
It knows the blast radius. Before an edit, the agent sees what imports a file, what historically changes with it, and how far a change ripples — "what breaks if I touch this?" is answered before the first keystroke.
It edits through the AST. 65+ symbol-level operations, atomic batches with all-or-nothing rollback, structural edits across 30+ languages, and a typecheck as the gate. Nothing breaks on whitespace.
It treats tokens as spend. The graph does the navigation models usually burn context on — fewer reads, fewer steps, smaller bills at any scale.

What's inside


Code genome	live dependency graph: tree-sitter across 30+ languages, PageRank + git co-change ranking, blast-radius tags, millisecond search
Symbol-level editing	65+ AST operations (atomic, with rollback) + structural edits in 30+ languages
Multi-agent	parallel explore/edit agents with a shared I/O cache — cheap models scout, strong models write
Task router	ten routable roles, any model in any seat, per tab — your own mixture of experts
Time machine	every prompt is a git checkpoint; rewind code and conversation together, land on any turn
Three surfaces	native desktop app, full terminal UI, headless CLI for scripts and CI — one genome, three phenotypes
LSP + MCP	576+ language servers via Mason, any MCP server, 13 lifecycle hooks
Free compaction	structural context compaction with no LLM call — long sessions stay cheap

One agent, many brains

Empryo isn't one model in a loop — it's a crew, and you assign the seats. Every role is a routable slot that takes any model from any of the 22 providers:

brain · spark scout · ember code · explore · verify review · goal review · desloppify · summarize · compact · web search

Per tab. Each workspace tab carries its own routing — a frontier model writing code in one tab, a fast cheap one triaging issues in the next, a local model on a private repo in a third.
Per config. Set defaults globally or per project; override any slot from the tab. Cheap models scout, strong models write, reviewers judge with clean context.
Custom agents. Define your own agents — a prompt, a model, a tool policy — and dispatch them alongside the built-ins. Mix and match providers freely inside a single run.
Cache-aware by design. Routing keeps prompt-cache prefixes stable — sub-agents inherit their parent's cache line, so repeated context bills at cache-read rates instead of full price.
Costs, itemized. Live spend tracking per model, per sub-agent, per tab, per session, per day — you always know where the tokens went.

Benchmarks

Head-to-head against pi — same models, same repositories, same tasks. The graph does more with less:

	Round 1 3 bugs × 3 models	Round 2 5 real bugs · hono / zod / ky
Bugs fixed	8/9 vs 7/9	7/10 vs 6/10
Cost	28% lower — $1.13 vs $1.58	23% lower — $7.08 vs $9.19
Wall-clock	57% faster — 4m 16s vs 10m	32% faster — 22m 30s vs 32m 55s
Efficiency	5.7× fewer input tokens — 1.09M vs 6.21M	28% fewer steps — 274 vs 382

Round 2 used real bugs from merged PRs (post-training-cutoff, history scrubbed, regression tests injected after each run). Full methodology and transcripts: empryo.com/benchmarks · reproduce at proxysoul/pi-vs-empryo-bench.

Private by design

Empryo runs entirely on your machine. Bring your own key — Anthropic, OpenAI, Google, Groq, DeepSeek, Bedrock, and 16 more, or any OpenAI-compatible endpoint — or run fully local with Ollama / LM Studio. No proxy in the middle, no code leaving your machine, no per-seat fee. Free to use.

SoulForge

SoulForge remains available to download and install, and continues to receive fixes for bugs and critical issues. New features and active development have moved 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 remains archived here under its existing license (see LICENSE).

Frequently Asked Questions

What is Empryo?

Empryo is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by proxysoul. Empryo issue tracker + SoulForge (v2) archive — Empryo is the graph-powered AI coding agent that edits symbols, not strings: AST surgery, full LSP, a live code genome. Get it at https://empryo.com. It has 887 GitHub stars.

Is Empryo safe to use?

Empryo returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install Empryo?

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

What programming language is Empryo written in?

Empryo 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 Empryo?

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 Empryo 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

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

236,687

35,984

JavaScript

AI Agentsai-agentsanthropic

View details

Compare

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

20,863

Shell

AI Agentsaibrainstorming

The agent that grows with you

223,514

43,045

Python

AI Agentsaiai-agent

View details

Compare

n8n

by n8n-io

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

198,901

59,815

TypeScript

MCP Serversaiapis

View details

Compare

everything-claude-code

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,940

28,768

JavaScript

AI Agentsai-agentsanthropic

View details

Compare

cc-switch

by farion1231

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

123,006

8,320

Rust

AI Agentsai-toolsclaude-code

View details

Compare

Browse all AI Agents skills

shuorenhua WindowsAgentArena

Empryo

previously SoulForge

The AI coding agent that edits symbols, not strings.

Empryo reads your repository as a living system: it sequences a genome — a live, ranked dependency graph of every symbol — and edits through the AST, never find-and-replace.

Website · Download · Benchmarks · Changelog · Discussions · Discord

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

empryo --set-key anthropic sk-ant-...   # or run locally with Ollama — no key required
cd your-project
empryo

Desktop app and prebuilt binaries: empryo.com/download. Runs on macOS, Linux, and Windows.

Why Empryo

Most coding agents grep, read whole files, and patch strings — they never know what depends on the code they just changed. Empryo builds understanding before it mutates anything:

It maps before it reads. On launch, tree-sitter parses your repo into a live graph — every symbol, import, and call site, ranked by PageRank and git co-change. Graph queries answer in milliseconds and cost zero LLM tokens.
It knows the blast radius. Before an edit, the agent sees what imports a file, what historically changes with it, and how far a change ripples — "what breaks if I touch this?" is answered before the first keystroke.
It edits through the AST. 65+ symbol-level operations, atomic batches with all-or-nothing rollback, structural edits across 30+ languages, and a typecheck as the gate. Nothing breaks on whitespace.
It treats tokens as spend. The graph does the navigation models usually burn context on — fewer reads, fewer steps, smaller bills at any scale.

What's inside


Code genome	live dependency graph: tree-sitter across 30+ languages, PageRank + git co-change ranking, blast-radius tags, millisecond search
Symbol-level editing	65+ AST operations (atomic, with rollback) + structural edits in 30+ languages
Multi-agent	parallel explore/edit agents with a shared I/O cache — cheap models scout, strong models write
Task router	ten routable roles, any model in any seat, per tab — your own mixture of experts
Time machine	every prompt is a git checkpoint; rewind code and conversation together, land on any turn
Three surfaces	native desktop app, full terminal UI, headless CLI for scripts and CI — one genome, three phenotypes
LSP + MCP	576+ language servers via Mason, any MCP server, 13 lifecycle hooks
Free compaction	structural context compaction with no LLM call — long sessions stay cheap

One agent, many brains

Empryo isn't one model in a loop — it's a crew, and you assign the seats. Every role is a routable slot that takes any model from any of the 22 providers:

brain · spark scout · ember code · explore · verify review · goal review · desloppify · summarize · compact · web search

Per tab. Each workspace tab carries its own routing — a frontier model writing code in one tab, a fast cheap one triaging issues in the next, a local model on a private repo in a third.
Per config. Set defaults globally or per project; override any slot from the tab. Cheap models scout, strong models write, reviewers judge with clean context.
Custom agents. Define your own agents — a prompt, a model, a tool policy — and dispatch them alongside the built-ins. Mix and match providers freely inside a single run.
Cache-aware by design. Routing keeps prompt-cache prefixes stable — sub-agents inherit their parent's cache line, so repeated context bills at cache-read rates instead of full price.
Costs, itemized. Live spend tracking per model, per sub-agent, per tab, per session, per day — you always know where the tokens went.

Benchmarks

Head-to-head against pi — same models, same repositories, same tasks. The graph does more with less:

	Round 1 3 bugs × 3 models	Round 2 5 real bugs · hono / zod / ky
Bugs fixed	8/9 vs 7/9	7/10 vs 6/10
Cost	28% lower — $1.13 vs $1.58	23% lower — $7.08 vs $9.19
Wall-clock	57% faster — 4m 16s vs 10m	32% faster — 22m 30s vs 32m 55s
Efficiency	5.7× fewer input tokens — 1.09M vs 6.21M	28% fewer steps — 274 vs 382

Private by design

SoulForge

SoulForge remains available to download and install, and continues to receive fixes for bugs and critical issues. New features and active development have moved 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 remains archived here under its existing license (see LICENSE).

Empryo

Empryo

Install

Why Empryo

What's inside

One agent, many brains

Benchmarks

Private by design

SoulForge

This repository

Sponsors

Frequently Asked Questions

What is Empryo?

Is Empryo safe to use?

How do I install Empryo?

What programming language is Empryo written in?

Are there alternatives to Empryo?

Related Skills

Empryo

Empryo

Install

Why Empryo

What's inside

One agent, many brains

Benchmarks

Private by design

SoulForge

This repository

Sponsors

Frequently Asked Questions

What is Empryo?

Is Empryo safe to use?

How do I install Empryo?

What programming language is Empryo written in?

Are there alternatives to Empryo?

Related Skills