Skip to content

proxysoul/soulstack

v1.5.0MIT

ProxySoul's agent stack: design, testing, marketing, performance, security and video skills, immune cells and working takeaways as rules.

Get started

macOS, Linux

curl -fsSL https://raw.githubusercontent.com/proxysoul/SoulStack/main/scripts/setup.sh | sh

Windows

irm https://raw.githubusercontent.com/proxysoul/SoulStack/main/scripts/setup.ps1 | iex

That's it. It finds your agents (Empryo, Claude Code, Codex, Copilot CLI, pi, OpenCode, Gemini CLI), links the skills and immune cells, and adds the rules. Every file it touches is backed up first, and your own rules stay.

Other ways in:

WantRun
Let your agent do itSet up SoulStack for me from https://github.com/proxysoul/SoulStack and follow its AGENTS.md.
Only some skills, any agentnpx skills add proxysoul/SoulStack (pick Universal for Empryo)
Copilot CLI plugincopilot plugin marketplace add proxysoul/SoulStack then copilot plugin install soulstack@soulstack

Stay current:

soulstack update    # get the latest and show what changed
soulstack check     # is a new version out?
soulstack remove    # take it out; your own rules stay

Pick a skill

Just ask your agent. It loads the right skill when the task matches.

You want to…Skill
Make a hype edit of your project, synced to a songenkindle
Make your app faster, with before-and-after proofenliven
Redesign your site with a real design systemensoul
Find security holes in your code and dependenciesenshield
Test the real app and never see the same bug twiceimmune-system
Launch and market it with real evidencemarketing

Each skill has a page in the docs.

Also inside

PartWhat it is
RulesHow every agent works: finish the job, prove it, report with visuals, use memory
Ten immune cellsAgents that scout, attack, verify and guard your app, led by tcell-helper
Working habitsMap first, read before editing, check after every change, answer short
SoulStack's own immune systemThe worked example; run bun run immune:app to see it
Prompts and templatesThe redesign brief in one message, and starting points for your own skills
Mascot guideDraw a calm mascot of your own. Shown with Mote, Empryo's mascot, which is not part of the stack
WebsiteEvery layer shown visually, plus llms.txt for agents

Best with Empryo

SoulStack works in any agent and goes further in Empryo: rules reload live, immune cells ask the code map where a bug lands, memory keeps confirmed bugs and traps, cells drive real apps through browser and computer use, and a nightly routine patrols for you.

Setup options

From a clone:

macOS, LinuxWindowsDoes
--presets proxysoul,proxysoul-mcp-Presets proxysoul,proxysoul-mcpAlso add my Empryo presets
--check-CheckChange nothing, show what is installed
--remove-RemoveTake SoulStack out again
--skills <folder>-Skills <folder>Link the skills somewhere else
--plain-PlainNo colour or animation

Rules go into each agent's global rules file inside a marked block that updates in place. Setup follows CLAUDE_CONFIG_DIR, CODEX_HOME, COPILOT_HOME, PI_CODING_AGENT_DIR and GEMINI_CLI_HOME.

My Empryo setup

My global config as three presets in plugins/presets/:

PresetSets
proxysoulGPT-6 Sol as the main model, Astra for reviews and second opinions, Luna for grunt work and subagents; Undertow-style theme, desktop appearance, editor, agent features
proxysoul-trustedFull autonomy: yolo, auto-approve, every computer-use switch. Trusted machines only
proxysoul-mcpMCP servers; tokens come from environment variables, never the file

Add them with scripts/setup.sh --presets proxysoul,proxysoul-mcp, or for one launch with empryo --plugin <path>. After changing settings in Empryo, refresh them with bun scripts/export-config.ts: it drops machine-only state, moves risky switches into the trusted preset, and refuses to write anything that looks like a secret.

Credits