Pu.sh: Um Harness de Agente de Codificação com 400 Linhas de Script Shell do HN

Pu.sh é um harness completo para agentes de codificação escrito em ~400 linhas de shell script, projetado para máxima portabilidade. Requer apenas sh, curl e awk — sem npm, pip, Docker ou outras dependências. O projeto é inspirado no Pi (pi.dev) e usa as mesmas 7 ferramentas e modelo de edição de texto exato.

Principais Características

• Modelos suportados: Anthropic (Claude) e OpenAI
• 7 ferramentas integradas: bash, read, write, edit, grep, find, ls
• Modo REPL para uso interativo
• Compactação automática do contexto da conversa
• Capacidades de checkpoint/resume
• Modo pipe para scripts
• 90 testes sem API para verificar funcionalidades sem chamadas externas

Notavelmente ausentes: TUI, streaming, suporte a imagens, OAuth, compatibilidade com Windows — e, como diz o autor, "dignidade".

Código e Filosofia

O autor admite que não consegue ler a maior parte do código awk, que foi escrito por Pi/Claude/Codex. O loop de raciocínio lida com parsing JSON e chamadas de ferramentas entre turnos usando awk. O loop do agente em si é minúsculo — a maior parte da complexidade em CLIs de agentes reais vem da experiência do desenvolvedor e da robustez. O projeto é lançado sob uma regra autoimposta: sem novas dependências e com menos de 500 linhas de código.

Configuração

curl -sL pu.dev/pu.sh -o pu.sh && chmod +x pu.sh
./pu.sh

Tudo o que você precisa é curl, awk e uma chave de API. O autor incentiva os leitores a criarem seu próprio harness adaptado às suas necessidades.