agent-purge

项目简介

agent-purge 是一个本地 CLI 与 Web 控制台，用于把同一份共享人设应用到多个 coding agent。它把各 harness 的系统提示词入口统一为 install、shim、slash 三类通道，并提供 replace、strict、append、off 四种模式，可热切换、可还原。

核心功能

• 同一份 personas/<id>.md 正文可共享到多个受管 coding agent 入口；四种模式为 replace、strict（仅人设）、append、off，均可热切换与还原；三类交付通道为 install 写入托管配置、hooks 或插件，shim 前置同名命令，slash 在会话内切换；本地 Web 控制台与 CLI 可列出人设，并显示运行期 harness 支持、版本、注入层与通道可用性；支持 Codex、Claude、Grok、OMP、Hermes、ZCode、OpenCode、OpenCode2、dsh、Pi、Antigravity

适用场景

• 在 Codex、Claude 等多个 coding agent 间保持同一人设，避免逐个工具重写提示词；在单个会话中用 slash 命令切换人设或模式，且不改动磁盘；通过本地 Web 控制台选择人设并查看运行期 harness 支持与通道可用性；在本地 magpie 网关为多个 agent 的请求应用当前人设。

快速开始

• 使用 npm i -g agent-purge 全局安装，或运行 npx agent-purge web；运行 agent-purge web 打开 7788 端口本地控制台并生成 personas 目录，不想用界面可用 agent-purge ls；用 agent-purge codex 以当前人设启动 agent，或用 agent-purge pi --ask 做一次性提问；用 agent-purge ls、agent-purge use 管理或单次覆盖人设。

部署与要求

• 需要 Node.js 20 或更高版本，零依赖；数据默认位于 ~/.agent-purge/，可通过 AGENT_PURGE_HOME 修改位置；可选 magpie 插件需从仓库的 magpie-plugin 目录安装，而非 npm 包，并需先运行 node magpie-plugin/gen-personas.mjs 生成人设数据；dsh 的 cordis 插件需装入 desktop、web、headless 三个 profile，并在首次安装后重启一次以支持后续热更新。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。