Repolode
Enviar
ZiChuanLan

ZiChuanLan/agent-purge

Console web local e CLI que inserem ou substituem um único system prompt compartilhado (persona) em vários agentes de programação, como Claude Code, Codex e OpenCode.

Ver no GitHub
Estrelas
1,349
Forks
860
Issues abertas
0
Último commit
há 17 horas

O que é?

agent-purge oferece um arquivo de persona que é inserido no system prompt de vários harnesses de agentes de programação, incluindo codex, claude, opencode, pi, hermes e outros. Como cada harness lê o system prompt de um lugar diferente, a ferramenta disponibiliza três formas de integração: um bloco de configuração gerenciado instalado no harness, um shim no PATH que inicia o harness com a persona e um comando slash dentro da sessão para ativá-la ou desativá-la. Há quatro modos: replace, strict (somente a persona), append e off.

Um console web local em 127.0.0.1 lista as personas, mostra quais harnesses estão instalados e qual camada de injeção cada um usa, além de permitir ativar ou desativar a persona. Desativá-la ou executar a ferramenta no modo off reverte todas as alterações. As personas são arquivos Markdown simples com frontmatter, armazenados em um diretório de dados na pasta pessoal do usuário; o estado fica apenas na máquina local. O pacote requer Node 20+ e não tem dependências.

Um plugin opcional para o gateway local magpie reescreve o segmento system das requisições de agentes encaminhadas pelo gateway, permitindo aplicar uma alteração de persona sem reiniciar cada harness. Clientes desktop de código fechado são iniciados como estão, sem injeção.

Recursos principais

  • 01Insere uma persona em vários agentes de programação por meio de blocos de configuração, shims no PATH ou comandos dentro da sessão.
  • 02Oferece os modos replace, strict, append e off, que podem ser alternados em tempo de execução.
  • 03Console web local para listar personas, verificar o status dos harnesses e ativar ou desativar a injeção.
  • 04Todas as alterações podem ser revertidas com uninstall, disarm ou a mudança para off.
  • 05Plugin opcional para o gateway magpie reescreve os system prompts das requisições encaminhadas por ele.

Casos de uso

  • Manter uma persona ou um estilo de programação consistente no Claude Code, Codex e OpenCode.
  • Testar como diferentes system prompts alteram o comportamento dos agentes de programação.
  • Encaminhar vários agentes por um gateway local e mudar a persona de todos em um só lugar.

Início rápido

  1. 1

    Instale o CLI globalmente via npm

    npm i -g agent-purge
  2. 2

    Inicie o console web local

    agent-purge web
  3. 3

    Inicie um agente de programação com a persona atual (por exemplo, codex)

    agent-purge codex

Antes de usar

  • Requer Node.js 20 ou superior.
  • Agentes de desktop de código fechado são iniciados como estão e não podem receber o prompt por injeção.
  • O plugin opcional de gateway magpie deve ser instalado a partir de um git clone, e a lista de personas precisa ser gerada novamente após as alterações.
  • Os modos strict e replace podem degradar ou alterar o comportamento do harness, pois as instruções das ferramentas podem ser removidas.

Em coleções

Ferramentas, skills e plugins para Claude CodeAssistentes e agentes de programação com IAFerramentas de CLI e terminalFerramentas de privacidade e local-first

Tópicos

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

Perguntas frequentes

O que é agent-purge?
Console web local e CLI que inserem ou substituem um único system prompt compartilhado (persona) em vários agentes de programação, como Claude Code, Codex e OpenCode. agent-purge oferece um arquivo de persona que é inserido no system prompt de vários harnesses de agentes de programação, incluindo codex, claude, opencode, pi, hermes e outros. Como cada harness lê o system prompt de um lugar diferente, a ferramenta disponibiliza três formas de integração: um bloco de configuração gerenciado instalado no harness, um shim no PATH que inicia o harness com a persona e um comando slash dentro da sessão para ativá-la ou desativá-la. Há quatro modos: replace, strict (somente a persona), append e off.
agent-purge é gratuito? Qual é a licença?
agent-purge é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
agent-purge ainda é mantido?
Manutenção ativa. O último commit de agent-purge foi em 6 de nov. de 2026.
Para que posso usar agent-purge?
Manter uma persona ou um estilo de programação consistente no Claude Code, Codex e OpenCode. Testar como diferentes system prompts alteram o comportamento dos agentes de programação. Encaminhar vários agentes por um gateway local e mudar a persona de todos em um só lugar.
Como instalar agent-purge?
Instale o CLI globalmente via npm: npm i -g agent-purge Inicie o console web local: agent-purge web Inicie um agente de programação com a persona atual (por exemplo, codex): agent-purge codex
Onde consigo agent-purge?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ZiChuanLan/agent-purge

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados