Ponytail só funciona no Claude Code? O que muda ao usar em Codex, Cursor e outros agentes

Fala aí, beleza? O Ponytail nasceu com cara de coisa de Claude Code, e não é 🙂

Ele é um projeto open source de licença MIT publicado no GitHub sob o usuário DietrichGebert, descrito como um ruleset que faz o agente de código escrever menos código: o repositório é o DietrichGebert/ponytail

O lançamento foi em 12 de junho de 2026, e segundo reportagem de agosto de 2026 o projeto já passou de 82 mil estrelas

Aí vem a dúvida real de quem não vive dentro do Claude Code: se a minha stack é Codex, Cursor ou Gemini CLI, vale investir tempo nisso? Ou eu vou configurar meia hora pra descobrir que metade não funciona no meu ambiente?

Bora destrinchar isso…

Por que a mesma regra vale em agentes diferentes:

O que segura a portabilidade é uma decisão de arquitetura bem simples: a instrução canônica do Ponytail vive em um arquivo só, o skills/ponytail/SKILL.md

Todos os adaptadores leem dali, através de um instruction builder compartilhado

Na prática isso significa que Claude Code, Codex, OpenCode e o harness Pi recebem regras IDÊNTICAS

Se você conhece aquele padrão de arquivo de config único que várias ferramentas consomem, é exatamente essa ideia: uma fonte de verdade, vários consumidores

E o repositório ainda mantém um documento de portabilidade, o docs/agent-portability.md, que mapeia qual arquivo alimenta qual agente

Esse doc é o mapa oficial, não um resumo de terceiro

E o que essas regras mandam o agente fazer?

O coração do Ponytail é uma escada de decisão, e a ordem importa: o agente tem que parar no PRIMEIRO degrau que resolve a tarefa

1. pular a tarefa (YAGNI)
2. usar a biblioteca padrão
3. usar recurso nativo da plataforma
4. usar dependência já instalada
5. escrever uma linha
6. e só então escrever o mínimo que funciona

Repara que o primeiro degrau é não fazer nada, o que é bem o espírito de fazer na mão sai mais rápido em tarefa que nem precisava de agente

Ponytail em cada agente: o que você ganha em cada um:

A forma completa de plugin, com hooks, troca de modo e comandos, funciona num conjunto definido de agentes

Os demais entram pelo caminho somente de instrução, copiando o arquivo de regras correspondente do repositório

Agente	Forma de entrada	O que funciona
Claude Code	Plugin pelo marketplace de plugins	Plugin completo: comandos, hooks e níveis
Codex	Plugin pelo marketplace, skills chamadas com arroba (ex.: @ponytail-review)	Plugin completo: comandos, hooks e níveis
GitHub Copilot CLI	Plugin, com comandos prefixados (/ponytail:ponytail ultra, /ponytail:ponytail-review)	Plugin completo
Harness Pi	Comando próprio de instalação	Plugin completo
OpenCode	Plugin, padrão full, override por PONYTAIL_DEFAULT_MODE ou ~/.config/ponytail/config.json	Plugin completo, e o AGENTS.md já é autocarregado
Gemini CLI	Extensão	Ruleset sempre ativo como contexto e comandos /ponytail registrados
Cursor	Arquivo de regras em .cursor/rules/ponytail.mdc	Só instrução: ruleset sempre ativo
Windsurf	Arquivo de regras em .windsurf/rules/ponytail.md	Só instrução
Cline	Arquivo de regras em .clinerules/ponytail.md	Só instrução
Kiro	Arquivo em .kiro/steering/	Só instrução
GitHub Copilot	.github/copilot-instructions.md	Só instrução
Aider	Arquivo de regras do repositório	Só instrução
Extensão Codex do VS Code	AGENTS.md que o repositório já traz	Só instrução, funciona da raiz do projeto sem configuração

O que você perde ao sair do plugin completo:

Aqui mora a resposta honesta da pergunta do título: não é exclusivo, mas TAMBÉM não é a mesma coisa em todo lugar

No caminho somente de instrução o ruleset fica sempre ativo, o que já é o principal

Mas você abre mão de três coisas: dos comandos, dos hooks e da troca de níveis

Os seis comandos de skill que o Ponytail expõe são /ponytail, /ponytail-review, /ponytail-audit, /ponytail-debt, /ponytail-gain e /ponytail-help

E os quatro níveis de intensidade do ruleset são lite, full, ultra e off

No tier de instrução nada disso existe: é o arquivo de regra e ponto

E os hooks, o que eles fazem afinal?

Os plugins de Claude Code e de Codex rodam dois hooks de ciclo de vida em Node.js

Um é o SessionStart, que injeta o ruleset na sessão

O outro é o UserPromptSubmit, que rastreia a troca de modo com /ponytail lite|full|ultra

Tome cuidado com um detalhe: isso exige node no PATH

Se o node não estiver lá, as skills continuam funcionando e a ativação sempre ativa apenas fica silenciosa, em vez de cuspir erro a cada prompt

Ou seja, é uma degradação silenciosa: nada quebra na sua cara, mas o comportamento que você esperava não está lá 😬 esse tipo de armadilha entra fácil na lista de erros comuns de quem começa a mexer com agente

Um aviso pra não te induzir ao erro: esse par de hooks em Node.js é o que está documentado pros plugins de Claude Code e de Codex

Os outros agentes que também rodam a forma completa de plugin (Copilot CLI, harness Pi e OpenCode) eu não vou afirmar que usam exatamente os mesmos hooks nem que exigem node no PATH, porque isso eu não tenho confirmado

A referência pra checar caso a caso é o docs/agent-portability.md do repositório

Ressalvas por agente:

No Gemini, o mapa de hooks usado em Claude Code e Codex não é colocado no caminho de hooks autodescoberto: o hooks/hooks.json do Gemini não recebe esse mapa

No Copilot CLI, quando você roda a forma plugin, os comandos vêm prefixados com o nome do plugin: /ponytail:ponytail ultra, /ponytail:ponytail-review

E tem um caso que joga a favor: o OpenCode carrega automaticamente o AGENTS.md do repositório

Ou seja, as regras já valem ali mesmo sem o plugin instalado

Como instalar o Ponytail no seu agente:

Comando por ambiente, com o tropeço de cada um

1. Claude Code: adicione o marketplace e instale o plugin

/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail

O erro comum deste passo: rodar sem node no PATH e achar que o ruleset está ativo, porque a falha é silenciosa e não aparece erro nenhum

2. Codex: a instalação também é por plugin

codex plugin marketplace add DietrichGebert/ponytail

O erro comum deste passo: procurar barra na hora de chamar a skill, porque no Codex a invocação é com arroba, tipo @ponytail-review

3. Gemini CLI: aqui o Ponytail entra como extensão, carregando o ruleset como contexto sempre ativo e registrando os comandos /ponytail

gemini extensions install https://github.com/DietrichGebert/ponytail

O erro comum deste passo: contar com os hooks, já que o mapa de hooks não vai pro caminho autodescoberto do Gemini

4. Harness Pi: a instalação é por um comando próprio

pi install git:github.com/DietrichGebert/ponytail

5. Editores que não executam skills: copie o arquivo de regras correspondente do repositório pro caminho que o editor lê, seguindo a tabela lá de cima (.cursor/rules/ponytail.mdc no Cursor, .windsurf/rules/ponytail.md no Windsurf, .clinerules/ponytail.md no Cline, .kiro/steering/ no Kiro, .github/copilot-instructions.md no GitHub Copilot)

6. Extensão Codex do VS Code: ela lê o AGENTS.md que o repositório já traz, funcionando a partir da raiz do projeto sem configuração nenhuma

Pra tornar a regra global, o arquivo vai em ~/.codex/AGENTS.md

7. GitHub Copilot CLI, pelo caminho de arquivo de instrução: dentro de um projeto ele lê AGENTS.md e .github/copilot-instructions.md, e as regras podem ser copiadas pra ~/.copilot/copilot-instructions.md pra valer em todo projeto

O Copilot CLI também aparece no grupo que roda a forma completa de plugin, mas o comando de instalação do plugin nele eu não vou chutar aqui: nesse caso, o README do repositório é a fonte

O erro comum deste passo: deixar a regra só na raiz de um projeto e achar que ela vale em todos

8. O erro comum transversal: esperar comando /ponytail em ambiente que só lê arquivo de regra

Não vai aparecer, e não é bug: é o tier em que o seu agente caiu

Vale a pena no seu setup? Três cenários:

Cenário 1: você vive no terminal

Se o seu dia é Claude Code, Codex ou Copilot CLI, você leva o pacote inteiro: comandos, hooks e a troca entre lite, full, ultra e off

Aqui o Ponytail entrega tudo o que ele tem pra entregar

Cenário 2: você edita no Cursor ou no Windsurf

Você ganha o ruleset sempre ativo, que é o miolo da coisa, mas precisa aceitar que a intensidade fica no que o arquivo define

Sem /ponytail ultra no meio da tarefa pra apertar o parafuso

Cenário 3: time misto no mesmo repositório

Esse é o caso mais massa, na minha opinião

Um dev no Claude Code, outro no Cursor, outro no Codex do VS Code: o AGENTS.md na raiz mais os arquivos por editor mantêm a MESMA regra pra todo mundo

E isso funciona justamente porque tudo deriva do mesmo SKILL.md

O que a prática com agentes mostra sobre regras portáteis:

Aqui eu não vou fingir que fiz benchmark do Ponytail, porque não fiz

Mas eu já operei agente em cima de regra compartilhada, e tem umas coisas que só aparecem na mão

No vídeo abaixo eu monto uma empresa inteira de agentes de IA, com Paperclip e Claude Code (é orquestração, outro tipo de bicho, não é o Ponytail)

Antes de abrir o terminal eu fiz um mapa mental pra explicar o conceito, porque o modelo mental importa mais que o comando: o agente de IA é o funcionário e o orquestrador é a empresa, com meta definida, time contratado, orçamento aprovado e acompanhamento por dashboard

E o funcionário não precisa ser sempre o mesmo tipo: na explicação eu cito agentes de código, ferramentas de terminal e chamadas HTTP como possíveis executores

É exatamente por isso que amarrar comportamento num arquivo único faz diferença quando tem mais de um agente no mesmo projeto

Se a regra mora na cabeça de quem abriu o terminal, ela some na primeira troca de janela

A parte chata do setup:

Eu defendi rodar em VPS em vez do PC pessoal, pra não depender da máquina ligada e poder monitorar a distância (na sua máquina também funciona, só é outra vida)

Instalei Node, depois pnpm, e o comando do pnpm simplesmente não respondeu mesmo depois de reabrir o shell: tive que localizar o prefixo do npm e exportar o caminho no PATH

A primeira inicialização também falhou: lendo o erro, atribuí ao banco de dados usado pela ferramenta, que não aceitava rodar sob o usuário root

Criei um usuário dedicado, troquei de usuário, e aí o mesmo problema de caminho voltou, resolvido de novo exportando o PATH antes do onboarding

Guarda esse padrão, porque ele repete: PATH e permissão são metade dos perrengues de qualquer ferramenta de agente

Pra acessar o painel eu preferi túnel SSH pelo CMD em vez de abrir porta na internet, já que porta aberta deixa a interface acessível pra qualquer um

O ganho real que eu senti:

Dois pontos me pegaram: o controle de orçamento por agente, com corte automático ao atingir o limite, que traz previsibilidade de custo com IA

E o contexto compartilhado com auditoria visual, que evita ficar alternando entre janelas e se perdendo entre os trabalhos

Meu critério de quando usar orquestração foi esse: quem já mantém mais de um agente de código aberto em projetos diferentes, quem quer execução contínua sem ficar startando processo, quem precisa monitorar custo e quem toca vários objetivos em paralelo

E de quando NÃO usar: um agente por vez, tarefas pontuais sem continuidade, casos em que um setup simples já resolve e uso casual ou exploratório

O paralelo com o Ponytail é direto: quanto mais agente rodando junto, mais cara a conta de um agente que superconstrói, e mais valor tem uma regra que vale igual pra todos eles

Veredito: preso ao Claude Code ou não?

Não, o Ponytail não é exclusivo do Claude Code

Mas a experiência é escalonada, e o Claude Code está no grupo que recebe tudo: plugin, hooks, comandos e níveis

Se a sua stack é Cursor ou Windsurf, você leva o miolo (o ruleset) e deixa os controles pra trás

E agora a parte dos números, que merece honestidade 👀

A alegação inicial de 80% a 94% menos código veio de uma baseline falha: a comparação era contra um modelo de chat puro, que enche a resposta de prosa, ressalvas e implementações alternativas

Esse claim foi considerado inválido depois da contestação de um contribuidor

O mantenedor refez o benchmark como execução agêntica real e publicou o número corrigido, que é o vigente hoje: cerca de 54% menos código em média, chegando a 94% onde o agente ia superconstruir e perto de zero onde o código já era enxuto

O README atual também reporta cerca de 20% menos custo e 27% mais rápido

E o próprio README sinaliza o que estava errado antes: 94% é TETO por tarefa, não média

Respeito muito quando o projeto corrige o próprio número em público, isso é raro no meio 😀

Conclusão:

O próximo passo é bem objetivo: identifica em qual tier o teu agente cai

Se ele está no grupo do plugin completo, roda o comando de instalação correspondente e aproveita os comandos e os níveis

Se ele só lê arquivo de regra, copia o arquivo certo pro caminho certo e para de esperar /ponytail na tela

E antes de sair adaptando na mão, dá uma lida no docs/agent-portability.md do repositório, que é o mapa oficial de qual arquivo alimenta qual agente

Ferramenta de agente muda rápido, então vale acompanhar o repo e o changelog do projeto

Por aqui eu sigo cobrindo essas ferramentas de agente conforme elas aparecem, até o próximo post!

Perguntas frequentes

O Ponytail funciona no Cursor mesmo sem suporte a plugins?

Funciona, mas pelo caminho só de instrução. O arquivo de regras fica em .cursor/rules/ponytail.mdc e mantém o ruleset sempre ativo, só que sem os comandos, sem hooks e sem troca de níveis que o plugin completo tem.

É verdade que o Ponytail reduz de 80% a 94% o código gerado?

Não é o número vigente. Esse claim inicial veio de uma baseline falha, comparada contra um modelo de chat puro cheio de prosa e ressalvas, e foi contestado por um contribuidor. O mantenedor refez o benchmark como execução agêntica real e o número corrigido é de cerca de 54% menos código em média, com o README deixando claro que os 94% eram teto por tarefa, não média. O README também reporta cerca de 20% menos custo e 27% mais rápido.

Preciso ter Node.js instalado pra usar o Ponytail no Claude Code?

Os hooks do plugin (SessionStart e UserPromptSubmit) rodam em Node.js e exigem node no PATH. Se o node não estiver disponível, as skills continuam funcionando normalmente, só que a ativação sempre ativa fica silenciosa em vez de dar erro a cada prompt.

O Ponytail é gratuito e open source?

Sim. É um projeto open source de licença MIT, publicado no repositório DietrichGebert/ponytail no GitHub, lançado em 12 de junho de 2026. Segundo reportagem de agosto de 2026, o projeto já passou de 82 mil estrelas.

Dá pra usar o Ponytail no VS Code com a extensão Codex sem configurar nada?

Dá. A extensão lê o AGENTS.md que o repositório já traz e funciona a partir da raiz do projeto sem configuração extra. Pra valer em todo projeto, é só colocar o arquivo em ~/.codex/AGENTS.md e o escopo vira global.

Os comandos do Ponytail no GitHub Copilot CLI são iguais aos do Claude Code?

Não exatamente. O Copilot CLI roda o plugin completo, mas prefixa os comandos com o nome do plugin, então fica /ponytail:ponytail ultra e /ponytail:ponytail-review em vez da forma direta que aparece no Claude Code.