Repolode
Enviar
ZiChuanLan

ZiChuanLan/agent-purge

Consola web local y CLI para inyectar o reemplazar un prompt de sistema compartido (persona) en varios agentes de programación, como Claude Code, Codex y OpenCode.

Ver en GitHub
Estrellas
1,349
Forks
860
Issues abiertos
0
Último commit
hace 10 horas

¿Qué es?

agent-purge ofrece un único archivo de persona que se incorpora al prompt de sistema de varios entornos de agentes de programación, como codex, claude, opencode, pi, hermes y otros. Cada entorno obtiene el prompt de sistema de una ubicación distinta, así que la herramienta ofrece tres canales: un bloque de configuración administrado que se instala en el entorno, un shim en PATH que inicia el entorno con la persona y un comando de barra dentro de la sesión para activarla o desactivarla. Hay cuatro modos disponibles: replace, strict (solo la persona), append y off.

Una consola web local en 127.0.0.1 muestra las personas, indica qué entornos están instalados y qué capa de inyección usa cada uno, y permite activar o desactivar la persona. Al desactivarla o usar el modo off, se revierten todos los cambios. Las personas son archivos Markdown simples con frontmatter, almacenados en un directorio de datos dentro del directorio de inicio del usuario; el estado se conserva únicamente en la máquina local. El paquete requiere Node 20+ y no tiene dependencias.

Un plugin opcional para el gateway local magpie reescribe el segmento de sistema de las solicitudes de los agentes que pasan por el gateway, de modo que un cambio de persona surte efecto sin reiniciar cada entorno. Los clientes de escritorio de código cerrado solo se inician tal cual, sin inyección.

Funciones clave

  • 01Incorpora una persona en varios agentes de programación mediante bloques de configuración, shims en PATH o comandos dentro de la sesión.
  • 02Ofrece los modos replace, strict, append y off, que se pueden cambiar en tiempo de ejecución.
  • 03Consola web local para mostrar las personas, consultar el estado de los entornos y activar o desactivar la inyección.
  • 04Todos los cambios se pueden revertir mediante uninstall, disarm o al cambiar al modo off.
  • 05Plugin opcional para el gateway magpie que reescribe los prompts de sistema de las solicitudes que pasan por él.

Casos de uso

  • Mantener una persona o un estilo de programación coherentes en Claude Code, Codex y OpenCode.
  • Probar cómo los distintos prompts de sistema cambian el comportamiento de los agentes de programación.
  • Enrutar varios agentes a través de un gateway local y cambiar su persona desde un único lugar.

Inicio rápido

  1. 1

    Instala el CLI globalmente mediante npm

    npm i -g agent-purge
  2. 2

    Inicia la consola web local

    agent-purge web
  3. 3

    Inicia un agente de programación con la persona actual (p. ej., codex)

    agent-purge codex

Antes de usarlo

  • Requiere Node.js 20 o posterior.
  • Los agentes de escritorio de código cerrado solo se inician tal cual; no se les puede inyectar el prompt.
  • El complemento opcional de gateway magpie debe instalarse mediante un git clone y, tras los cambios, hay que volver a generar la lista de personas.
  • Los modos strict y replace pueden degradar o alterar el comportamiento del harness, ya que es posible que se eliminen instrucciones para las herramientas.

En colecciones

Herramientas, skills y plugins para Claude CodeAsistentes y agentes de programación con IAHerramientas de CLI y terminalHerramientas de privacidad y local-first

Temas

#coding-agent#system-prompt#prompt-engineering#cli#claude-code#codex#local-first#opencode#pi

Preguntas frecuentes

¿Qué es agent-purge?
Consola web local y CLI para inyectar o reemplazar un prompt de sistema compartido (persona) en varios agentes de programación, como Claude Code, Codex y OpenCode. agent-purge ofrece un único archivo de persona que se incorpora al prompt de sistema de varios entornos de agentes de programación, como codex, claude, opencode, pi, hermes y otros. Cada entorno obtiene el prompt de sistema de una ubicación distinta, así que la herramienta ofrece tres canales: un bloque de configuración administrado que se instala en el entorno, un shim en PATH que inicia el entorno con la persona y un comando de barra dentro de la sesión para activarla o desactivarla. Hay cuatro modos disponibles: replace, strict (solo la persona), append y off.
¿agent-purge es gratuito? ¿Qué licencia tiene?
agent-purge es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿agent-purge sigue mantenido?
Mantenimiento activo. El último commit de agent-purge fue el 6 nov 2026.
¿Para qué puedo usar agent-purge?
Mantener una persona o un estilo de programación coherentes en Claude Code, Codex y OpenCode. Probar cómo los distintos prompts de sistema cambian el comportamiento de los agentes de programación. Enrutar varios agentes a través de un gateway local y cambiar su persona desde un único lugar.
¿Cómo se instala agent-purge?
Instala el CLI globalmente mediante npm: npm i -g agent-purge Inicia la consola web local: agent-purge web Inicia un agente de programación con la persona actual (p. ej., codex): agent-purge codex
¿Dónde consigo agent-purge?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ZiChuanLan/agent-purge

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados