# SoulStack > ProxySoul's agent stack for Empryo, Claude Code, Codex, Copilot CLI, pi and OpenCode: working rules, the ensoul and immune-system skills, ten immune-cell agents, and Empryo presets. One setup command, one update command. Every page below is plain Markdown. Paths like `~/dev/SoulStack` are defaults in the user's home folder, not fixed locations. To install for a user, run the setup script and show its output; it asks nothing and backs up every file it changes. ## Guide - [Getting started](https://soulstack.proxysoul.com/docs/getting-started.md): Install SoulStack for every agent on your machine with one command, then check it worked. - [Best with Empryo](https://soulstack.proxysoul.com/docs/with-empryo.md): What SoulStack does better inside Empryo, the agent it comes from. - [Setup options](https://soulstack.proxysoul.com/docs/setup.md): Every flag and environment variable of the setup script, what it writes, and how it behaves when an agent runs it. - [Updating](https://soulstack.proxysoul.com/docs/update.md): How soulstack update works, what it shows, and what happens to your local changes. - [Supported agents](https://soulstack.proxysoul.com/docs/supported-agents.md): Where SoulStack writes for Empryo, Claude Code, Codex, Copilot CLI, pi and OpenCode, and how each is detected. - [Copilot plugin](https://soulstack.proxysoul.com/docs/copilot-plugin.md): Install SoulStack as a GitHub Copilot CLI plugin instead of running the setup script. - [Empryo presets](https://soulstack.proxysoul.com/docs/presets.md): ProxySoul's optional Empryo configuration layers and how to add them. ## Reference - [The immune system](https://soulstack.proxysoul.com/docs/immune-system.md): SoulStack's way of testing a product through its real front doors, with ten immune cells that find, verify and remember bugs. - [Immune cells](https://soulstack.proxysoul.com/docs/immune-cells.md): The ten agents of the immune system and when to call each one. - [Rules every agent follows](https://soulstack.proxysoul.com/docs/rules.md): The takeaways SoulStack adds to each agent's global rules file. - [Troubleshooting](https://soulstack.proxysoul.com/docs/troubleshooting.md): Fixes for the common setup and update problems. - [Mascot guide](https://soulstack.proxysoul.com/docs/mascot-guide.md): How to draw a calm mascot of your own. Shown with Mote, Empryo's mascot, which is not part of the stack. ## Skills - [Skill: ensoul](https://soulstack.proxysoul.com/docs/skills/ensoul.md): Build a product's design system and redesign its website (or any product UI) from scratch into a distinctive, alive, theme-aware site that is grounded in what the product really is. The agent first studies the codebase and the owner's way of talking to find the product's concept and vibe, then plans a design system of connected variants (palette, logos, screenshots) on one spacing scale, builds every page with parallel sub-agents, captures real product imagery, verifies by looking at screenshots at phone, laptop and ultra-wide widths in every theme and mode, and finishes by writing a design_system/ folder so the next agent can continue without context. Use when the user asks to redesign, rebuild or "bring to life" a product website, landing page or docs site, or asks for a design system handoff. - [Skill: immune-system](https://soulstack.proxysoul.com/docs/skills/immune-system.md): Build and run an immune system that proves a product works through its real front doors (CLI, terminal UI, desktop app, web, API) on every platform it ships to, finds what is missing as well as what is broken, and turns every confirmed bug into a permanent check. Use when a project needs testing beyond unit tests, before a release, when a bug keeps coming back, or when the user asks for specialized immune cells. ## Immune cells - [tcell-helper](https://soulstack.proxysoul.com/docs/immune-cells/tcell-helper.md): The one entry point to the immune system. Reads the current state of the immune system, decides which immune cells run and in what order, and owns the consolidated verdict. Use when you are not sure which immune cell you need, or the job spans several. Examples - "is the product healthy", "get me release confidence", "something feels off on Windows", "improve our immune system". Stem cell: grows into this project's own version on first run. - [dendritic](https://soulstack.proxysoul.com/docs/immune-cells/dendritic.md): Finds behaviour that is MISSING rather than broken - states a screen forgets, platform conventions the product ignores, one front door behaving unlike another. Use for new features, unexplored screens, or "what are we not testing". Stem cell: grows into this project's own version on first run. - [memory-cell](https://soulstack.proxysoul.com/docs/immune-cells/memory-cell.md): Turns a confirmed bug into a permanent check so it can never come back unnoticed, proving the check fails before the fix and passes after it. Use right after a bug is confirmed or fixed. Stem cell: grows into this project's own version on first run. - [natural-killer](https://soulstack.proxysoul.com/docs/immune-cells/natural-killer.md): The security cell. Hunts compromised and vulnerable parts of the product without waiting to be told what to look for - known-vulnerable and malicious packages, leaked secrets, unsafe install scripts, unsigned or unpinned downloads, risky code paths, and container images. Use before a release, after adding or updating dependencies, or when anything touches credentials, installers or network code. Stem cell: grows into this project's own version on first run. - [negative-selection](https://soulstack.proxysoul.com/docs/immune-cells/negative-selection.md): Tries to disprove a claimed bug before it is filed, fixed or turned into a check. Attacks it from two sides - is the behaviour intended, and does it reproduce by hand outside the harness. Use for every claim from a hunt, an exploration, a patrol or a user report. Stem cell: grows into this project's own version on first run. - [tcell-armorer](https://soulstack.proxysoul.com/docs/immune-cells/tcell-armorer.md): Audits and improves the immune system itself - checks that pass on empty output, speed budgets that never fire, drivers that cannot see what matters, and instruments that are missing. Use every few patrols, or when another immune cell reports "we have no way to measure this". Stem cell: grows into this project's own version on first run. - [tcell-hunter](https://soulstack.proxysoul.com/docs/immune-cells/tcell-hunter.md): Adversarial bug hunter. Give it a feature, a front door or a recent diff and it invents hostile scenarios, runs them against the real product, and turns what breaks into checks. Use before shipping risky changes or when a bug class keeps coming back. Stem cell: grows into this project's own version on first run. - [tcell-patrol](https://soulstack.proxysoul.com/docs/immune-cells/tcell-patrol.md): Runs the project's immune system (its test suite) across every reachable platform and front door, then sorts every red result into real bug, check bug, environment problem, known, or healed. Use before a release, after a merge, or whenever the question is "is everything still working". Stem cell: grows into this project's own version on first run. - [tcell-platform](https://soulstack.proxysoul.com/docs/immune-cells/tcell-platform.md): Diagnoses failures that happen on one platform only (Linux containers, Windows over SSH, a VM) and knows which failures are the transport lying rather than the product. Use when a check is red on exactly one OS or a target is unreachable. Stem cell: grows into this project's own version on first run. - [tcell-retina](https://soulstack.proxysoul.com/docs/immune-cells/tcell-retina.md): Visual defect hunter for desktop, web and terminal UIs. Give it a screen, a screenshot or a complaint ("the dialog is see-through", "text is unreadable in light mode") and it finds which layer is wrong instead of guessing from pixels. Use for any rendering, contrast, clipping or layout bug. Stem cell: grows into this project's own version on first run. ## Optional - [Source on GitHub](https://github.com/proxysoul/SoulStack): the scripts, skills and agents themselves. - [Everything in one file](https://soulstack.proxysoul.com/llms-full.txt)