993 ·GitHub
What is this?
agent-purge lets you write one persona (system prompt) and apply it across many coding agent CLIs at once — Codex, Claude Code, OpenCode, Grok, pi, Hermes, omp, zcode — either replacing or injecting their default system prompts, managed from a local CLI plus a web console.
agent-purge lets you write one persona (system prompt) and apply it across many coding agent CLIs at once — Codex, Claude Code, OpenCode, Grok, pi, Hermes, omp, zcode — either replacing or injecting their default system prompts, managed from a local CLI plus a web console.Is this a CLI tool or does it have a GUI?It is a CLI with a bundled local web console for managing personas and switching modes; there is no cloud service, everything runs and stores data on your own machine.
It is a CLI with a bundled local web console for managing personas and switching modes; there is no cloud service, everything runs and stores data on your own machine.How do I install and start using it?It needs Node.js 20 or newer and has zero dependencies to install. On first run it generates a starter persona at personas/neutral.md and stores its state in ~/.agent-purge/, separate from the package so upgrades don't wipe your data.
It needs Node.js 20 or newer and has zero dependencies to install. On first run it generates a starter persona at personas/neutral.md and stores its state in ~/.agent-purge/, separate from the package so upgrades don't wipe your data.Does it work with every coding agent, even closed-source desktop apps?No — closed-source desktop clients that keep the system prompt server-side or baked into a binary can only be launched as-is; agent-purge detects this and prints the reason instead of pretending the injection worked.
No — closed-source desktop clients that keep the system prompt server-side or baked into a binary can only be launched as-is; agent-purge detects this and prints the reason instead of pretending the injection worked.What are the four prompt modes?off disables injection entirely; append puts the persona before the host's original system prompt unchanged; replace does the same but also strips the line that names the original model or vendor; strict replaces the whole system prompt with just the persona, which can also wipe out tool instructions.
off disables injection entirely; append puts the persona before the host's original system prompt unchanged; replace does the same but also strips the line that names the original model or vendor; strict replaces the whole system prompt with just the persona, which can also wipe out tool instructions.What is the magpie gateway plugin for?magpie is an optional local gateway plugin that rewrites the system-prompt text of any request passing through it — Claude Code, Codex, OpenCode, pi and others — to match your current persona, so you don't need to install agent-purge separately into every harness.
magpie is an optional local gateway plugin that rewrites the system-prompt text of any request passing through it — Claude Code, Codex, OpenCode, pi and others — to match your current persona, so you don't need to install agent-purge separately into every harness.Are the changes it makes reversible?Yes, every change can be undone with agent-purge uninstall, disarm, or --mode off, which restores all touched harnesses to their original state with nothing left behind.
Yes, every change can be undone with agent-purge uninstall, disarm, or --mode off, which restores all touched harnesses to their original state with nothing left behind.How does it actually reach each agent's system prompt?It uses three channels: writing into the harness's own managed config block (install), a small PATH shim that intercepts the bare command (shim), and an in-session /purge on|off|status slash command for hot-switching without touching disk.
It uses three channels: writing into the harness's own managed config block (install), a small PATH shim that intercepts the bare command (shim), and an in-session /purge on|off|status slash command for hot-switching without touching disk.What are similar projects?operator-memory, cleancode, acryl, agentmemory, openrig, ordewell, cocode, superpowers-zh
operator-memory, cleancode, acryl, agentmemory, openrig, ordewell, cocode, superpowers-zhWhich topics is it in?system-prompt, pi, agentic-coding, harness, privacy-first, opencode, deepseek-harness, cli-tool, prompt-engineering, customization, developers, local-first
system-prompt, pi, agentic-coding, harness, privacy-first, opencode, deepseek-harness, cli-tool, prompt-engineering, customization, developers, local-first