ponytail
DietrichGebert/ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Instalação
npx convez-ai DietrichGebert/ponytail1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README em português
Você conhece ele. Rabo de cavalo longo. Óculos ovais. Está na empresa há mais tempo que o próprio controle de versão. Você mostra a ele cinquenta linhas; ele as lê, não diz nada e substitui por uma só linha.
O rabo de cavalo coloca-o dentro do seu agente IA.
Antes / Depois
Você pede um seletor de datas. Seu agente instala flatpickr, escreve um componente wrapper, adiciona uma folha de estilo e inicia uma discussão sobre fusos horários.
Com o Rabo de Cavalo:
<!-- ponytail: browser has one -->
<input type="date">
Mais sobreviventes em examples/.
Números
Cinco tarefas do dia a dia (validador de email, debounce, soma CSV, cronômetro regressivo, limitador de taxa), três modelos e três braços: sem habilidade, a habilidade caveman e o Rabo de Cavalo. Dez execuções por célula; mediana reportada.
80-94% menos código, 42-75% menor custo e 3 a 6× mais rápido que um agente sem habilidade em todos os modelos do Claude. Cada atalho tomado pelo Rabo de Cavalo é marcado no código com o comentário ponytail: nomeando seu caminho de upgrade. Reproduza por conta própria: npx promptfoo eval -c benchmarks/promptfooconfig.yaml. Método e números brutos: benchmarks/. Tarefas em nível de produção, onde um agente sem restrições inflaciona muito mais, estão documentadas em benchmarks/results/.
Isso é o subproduto, não a proposta. São números do Claude e variam por modelo. Modelos capazes de seguir instruções seguem a escada e escrevem menos, mais barato e rápido. Modelos com raciocínio conciso podem ir na direção oposta: a escada é um passo de deliberação, então o modelo gasta tokens pensando trabalhando nas traves antes de salvar qualquer saída; junto com o conjunto de regras sempre ativo que pode custar mais do que o código menor economiza. No GPT-5.5 acontece isso. E tudo isso é em uma única passada: um prompt e uma resposta fora: uma sessão real de agente re-injeta as regras e executa a escada a cada turno, o que este benchmark não mede; então o custo por sessão pode cair de qualquer jeito. A regra nunca foi "menor número de tokens". É: escreva apenas o que a tarefa precisa e nunca corte validação, tratamento de erro, segurança ou acessibilidade. O código acaba pequeno porque é necessário, não golfeado (golfed), e essa é a parte que permanece mantível. Menor custo e latência são um efeito colateral nos modelos que seguem isso.
Como funciona
Antes de escrever o código, o agente para na primeira trave que sustenta:
1. Does this need to exist? → no: skip it (YAGNI)
2. Stdlib does it? → use it
3. Native platform feature? → use it
4. Installed dependency? → use it
5. One line? → one line
6. Only then: the minimum that works
Preguiçoso, não negligente: validação de limites de confiança, tratamento de perda de dados, segurança e acessibilidade nunca estão no bloco da guilhotina.
Instalação
O esforço máximo que o Rabo de Cavalo jamais pedirá a você:
Os plugins Claude Code e Codex executam dois pequenos hooks do ciclo de vida Node.js; então node precisa estar em seu PATH (nota para usuários Nix/nvm: deve estar no PATH da shell não interativa). Se não estiver, as habilidades ainda funcionam; apenas o acionamento sempre ativo fica silencioso ao invés de gerar erro a cada prompt.
Claude Code
/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail
Codex
codex plugin marketplace add DietrichGebert/ponytail
codex
Abra /plugins, selecione o marketplace Ponytail e instale-o. Em seguida, abra /hooks, revise e confie em seus dois hooks do ciclo de vida e inicie um novo thread.
Esta mesma instalação também cobre o app desktop do Codex: reinicie o aplicativo após instalar e ele pega o plugin.
GitHub Copilot CLI
copilot plugin marketplace add DietrichGebert/ponytail
copilot plugin install ponytail@ponytail
Em uma sessão interativa do Copilot CLI, use os equivalentes em barra (/):
/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail
O Copilot CLI nomeia comandos de plugins pelo nome do plugin. Por exemplo:
/ponytail:ponytail ultra
/ponytail:ponytail-review
Pi agent harness
pi install git:github.com/DietrichGebert/ponytail
OpenCode
Execute o OpenCode a partir de um checkout deste repositório (o plugin reutiliza seus hooks/ e skills/) e adicione ao opencode.json:
{ "plugin": ["./.opencode/plugins/ponytail.mjs"] }
Injeta as regras em cada turno no nível ativo; adiciona os comandos /ponytail (veja Comandos). O OpenCode também carrega automaticamente o AGENTS.md deste repositório, então as regras valem mesmo sem o plugin. O plugin adiciona os níveis lite/full/ultra/off.
O caminho ./ resolve contra seu projeto's opencode.json; para compartilhar um checkout entre projetos, aponte-o para o caminho absoluto do .mjs em vez disso (ele encontra seus hooks/ e skills/ relativos ao próprio arquivo).
Gemini CLI
gemini extensions install https://github.com/DietrichGebert/ponytail
Carrega as regras como contexto sempre ativo a cada sessão e registra os comandos /ponytail; as habilidades também são enviadas, ativando-se quando uma tarefa precisa delas.
Antigravity CLI
O Google está renomeando o Gemini CLI para Antigravity CLI (o binário agy); a mesma extensão instala lá:
agy plugin install https://github.com/DietrichGebert/ponytail
Ele reutiliza o .gemini-extension.json deste repositório. Uma diferença: o Antigravity converte os comandos /ponytail em habilidades, então você digita-os no chat (ex: /ponytail-review como uma mensagem) ao invés de selecioná-los de um menu barra (/). Até a migração ser concluída (por volta de 18 de junho de 2026), gemini extensions install ainda funciona também. Para executá-lo como regra sempre ativa, coloque o conjunto de regras em .agents/rules/.
OpenClaw
clawhub install ponytail
Instala o ponytail como uma habilidade (skill) do OpenClaw no ClawHub; as habilidades de revisão, auditoria, dívida e ajuda são instaladas da mesma forma (clawhub install ponytail-review, etc.). O OpenClaw aplica-o em tarefas de codificação e também expõe-o como um comando /ponytail. Sem o ClawHub, copie .openclaw/skills/ponytail para ~/.openclaw/skills/.
Foi só isso. Ele estaria orgulhoso. Não diria nada sobre isso.
Ativo em cada sessão, com um punhado de comandos (veja Comandos). /ponytail ultra existe quando o código-fonte te prejudicou pessoalmente. O texto de inicialização e mudança de modo mostra o modo atual.
Defina o nível para todas as novas sessões usando a varável de ambiente PONYTAIL_DEFAULT_MODE (lite/full/ultra/off) ou um campo defaultMode em ~/.config/ponytail/config.json (%APPDATA%\ponytail\config.json no Windows). O padrão é full.
Cursor, Windsurf, Cline, GitHub Copilot (editor), Aider, Kiro: copie o arquivo de regras correspondente deste repositório (.cursor/rules/, .windsurf/rules/, .clinerules/, .github/copilot-instructions.md, AGENTS.md, .kiro/steering/).
Kiro: copie .kiro/steering/ponytail.md para ~/.kiro/steering/ (global) ou em .kiro/steering/ no seu projeto.
Fallback do CLI GitHub Copilot (modo apenas instruções): ele lê AGENTS.md e .github/copilot-instructions.md em um projeto, ou copie as regras para ~/.copilot/copilot-instructions.md para executar o ponytail em todos os projetos. Este caminho mantém a orientação sempre ativa, mas não adiciona alternadores de modo de plugin nem ganchos (hooks).
O VS Code com a extensão Codex lê AGENTS.md, que este repositório distribui, então funciona da raiz do repositório sem configuração (~/.codex/AGENTS.md torna o Codex global).
Quais arquivos mapeiam para qual agente: Portabilidade de agentes.
Comandos
| Comando | O que ele faz |
|---|---|
/ponytail [lite | full | ultra | off] | Define a intensidade, ou desliga-o. Sem argumento relata o nível atual. |
/ponytail-review | Revisa o diff atual para super-engenharia (over-engineering), devolvendo uma lista de exclusão. |
/ponytail-audit | Auditoria do repositório inteiro por super-engenharia, não apenas o diff. |
/ponytail-debt | Colhe os atalhos ponytail: que você adiou para um livro-razão (ledger), assim "mais tarde" não se torna "nunca". |
/ponytail-help | Referência rápida para os comandos acima. |
Os comandos precisam de uma hospedadora capaz de habilidades (Claude Code, Codex, OpenCode, Gemini, pi). No Codex eles são skills; invoque com @ (@ponytail-review). Os adaptadores apenas instruções (Cursor, Windsurf, Cline, Copilot, Kiro, Antigravity) carregam o conjunto de regras sempre ativo sem os comandos.
Desenvolvimento
Ao alterar o texto das regras compactas, mantenha as cópias do agente alinhadas:
node scripts/check-rule-copies.js
npm test
O pacote da habilidade OpenClaw (.openclaw/skills/) é gerado a partir de skills/; reexecute node scripts/build-openclaw-skills.js após alterar uma habilidade; o conjunto de testes falha se estiver desatualizado.
O benchmark de correção gera Python para verificações de e-mail e CSV; python3 é tentado antes do python. As verificações de CSV precisam que o pandas esteja instalado localmente.
FAQ
Ele precisa de um arquivo de configuração?
Não. Um opcional ~/.config/ponytail/config.json ou a varável de ambiente PONYTAIL_DEFAULT_MODE pode definir o nível padrão, mas nada é obrigatório.
E se eu realmente precisar da classe cache de 120 linhas? Você não precisa. Insista mesmo assim e ele construirá. Lentamente. Corretamente. Enquanto olhando para você.
Ele escala? O código que você nunca escreveu escala infinitamente. Zero bugs, zero CVEs, 99% de uptime desde sempre (ou seja, 100%).
Por que "ponytail"? Você sabe exatamente por quê.
Licença
MIT. A licença mais curta que funciona.