O agente de programação Pi explicado: o que é, como funciona e o que o Pi 1.0 mudou

O que é o agente de programação Pi?

O Pi se descreve em uma linha no seu README: "a minimal, extensible agent harness that you can make your own." Uma harness (estrutura) é o programa que envolve um modelo de linguagem com um loop, ferramentas e uma interface de usuário, para que o modelo possa de fato ler arquivos, executar comandos e editar código. O Claude Code, o OpenAI Codex e o OpenCode também são harnesses, e juntos formam a categoria de CLI de programação agêntica. A diferença do Pi é o quão pouco ele traz e o quanto deixa você mudar.

Os números mostram que ele deixou de ser uma ferramenta de nicho há tempo:

Uma ressalva sobre o número de downloads: os números do npm incluem execuções de CI e apps que incorporam o SDK do Pi, então não são uma contagem de pessoas. Mesmo assim, 5,2 milhões por semana colocam o Pi em outra liga em relação à maioria dos agentes de código aberto, incluindo o bem mais novo DeepSeek Harness.

O Pi também é maior que a sua própria CLI. O agente pessoal OpenClaw, que tem 391,521 estrelas próprias, é construído com componentes do Pi. Armin Ronacher disse com clareza em seu post sobre o Pi: "what's under the hood of OpenClaw is a little coding agent called Pi."

Quem constrói o Pi e por que ele foi para a Earendil?

O Pi começou como um projeto paralelo de Mario Zechner, um desenvolvedor austríaco mais conhecido pelo framework de jogos libGDX. O gatilho foi a frustração com o Claude Code, que, segundo seu post de design, tinha virado uma "spaceship with 80% of functionality I have no use for", com prompts e ferramentas que mudavam a cada versão. Ele construiu uma harness em que nada é injetado pelas suas costas e lhe deu, nas palavras dele, "a name that's entirely un-Google-able, so there will never be any users."

Esse plano não sobreviveu ao OpenClaw. Quando o agente de Peter Steinberger viralizou e as pessoas descobriram que ele rodava no Pi, Mario escreveu que "any VC or big corp you can think of in this space has knocked on my door." Ele não quis montar uma startup em torno disso, então escolheu um lar.

A Earendil é uma corporação de benefício público sediada em Viena, fundada em 2025 por Armin Ronacher (criador do Flask, cerca de dez anos na Sentry) e Colin Daymond Hanna. Entre os investidores estão Accel, Balderton e os fundadores de n8n, OpenClaw, Revolut, Sentry e Slack. A promessa de licenciamento está no RFC do Armin: "Pi remains MIT licensed and that will not change." Alguns recursos de valor agregado futuros serão de código disponível e se tornarão código aberto após um prazo, e alguns recursos empresariais serão proprietários.

Nem todo mundo gostou da mudança. Uma resposta no r/LocalLLaMA lamentou perder "the only decent harness that isn't sketchy af." Seis meses depois, o histórico de commits responde melhor: Mario ainda tem 3,849 commits no repositório e Armin 849, e o núcleo continua MIT.

Como funciona o agente de programação Pi

O design inteiro cabe num guardanapo. Um modelo, um loop que "just loops until the agent says it's done" e quatro ferramentas.

O raciocínio de Mario para um núcleo tão pequeno é que os modelos de ponta já sabem o que é um agente de programação. "There does not appear to be a need for 10,000 tokens of system prompt," escreveu ele, e "these four tools are all you need for an effective coding agent." Existem auxiliares somente leitura (grep, find, ls), mas vêm desativados. As regras do seu projeto vêm de um arquivo AGENTS.md (o Pi também lê CLAUDE.md), muito parecido com a configuração do AGENTS.md do Claude Code, e um SYSTEM.md pode substituir totalmente o prompt padrão.

Essa captura mostra o hábito que os usuários do Pi elogiam. Peça ao Pi para adicionar um recurso a si mesmo e ele lê a própria documentação, escreve uma extensão na pasta de configuração e você executa /reload. O rodapé também mostra o contexto usado e o custo em dólares a cada turno, um detalhe pequeno que muda a forma de trabalhar.

Algumas outras mecânicas que vale conhecer antes de instalar:

• Sessões são árvores. Cada mensagem é guardada com um ID de origem em um arquivo JSONL, então /tree deixa você voltar a qualquer ponto e criar ramificações, e /fork ou /clone iniciam uma nova sessão a partir dali. /share transforma uma sessão em um link compartilhável.
• Direcionar durante a execução. Pressione Enter enquanto o Pi trabalha para enviar uma mensagem de direcionamento, ou Alt+Enter para enfileirar um acompanhamento para quando ele terminar.
• Compactação. Quando o contexto enche (por padrão, a 16,384 tokens do limite), o Pi resume as mensagens antigas e mantém intactos os últimos 20,000 tokens. A Earendil escreveu sobre como a compactação funciona se você quiser os detalhes internos.
• 30+ provedores. Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, xAI, OpenRouter, Ollama e mais, com /model para trocar no meio da sessão. O catálogo de modelos do Pi lista 1,541 modelos de 41 provedores.

O que o Pi deixa de fora de propósito

Esta é a parte que confunde a maioria dos novos usuários, então aqui vai tudo em uma tabela. Cada item é uma escolha deliberada e cada um tem um caminho alternativo documentado.

O argumento de Mario para deixar essas coisas de fora é sobre visibilidade. Sobre subagentes, do seu post de design: "You have zero visibility into what that sub-agent does. It's a black box within a black box." Sobre o modo de planejamento, ele prefere um arquivo PLAN.md que você pode ler, editar e versionar. Se você já usou subagentes do Claude Code e gostou, vai querer o pacote, e tudo bem. A proposta do Pi é que você escolhe.

A comunidade preencheu todos os espaços. O catálogo de pacotes mostra 5,553 pacotes listados, e vários dos mais baixados correspondem diretamente à tabela acima:

As extensões em si são arquivos TypeScript simples que podem registrar ferramentas, comandos com barra, atalhos de teclado, provedores de modelos e uma interface de terminal completa. A extensão de revisão do próprio Armin é um bom exemplo do quanto isso vai longe:

A contrapartida é que você vira o mantenedor da sua própria configuração. Um usuário antigo do Pi no Hacker News disse com justiça: "Pi's plugins are its strength, but also its weakness, because most feel more like personal vibe-coding projects than seriously maintained tools." A documentação diz o mesmo de forma mais sóbria: pacotes podem executar código, então "review third-party package source before installing it."

Pi 1.0: o agente "sem MCP" agora tem MCP

Durante quase toda a sua vida, o pi.dev trouxe uma frase orgulhosa dizendo que o Pi nunca suportaria o MCP, o protocolo que permite a um agente se conectar a um servidor MCP externo. O argumento de Mario era o custo de contexto. Ele mediu o servidor MCP do Playwright em 21 ferramentas e 13.7k tokens, e o Chrome DevTools MCP em 26 ferramentas e 18k tokens, o que chamou de "7-9% of your context window gone before you even start working."

Em 29 de setembro de 2026, a Earendil reverteu isso em um post intitulado "You Said No MCP!" O raciocínio: "the MCP of today is not the MCP of yesteryear," e as mudanças de que o MCP precisava eram "generally useful." Dois dias depois, o Pi 1.0 saiu com ele como destaque. A página inicial agora diz "No MCP Now with MCP+Codemode."

O truque que mantém a promessa de tokens é o Codemode. Em vez de entregar ao modelo o esquema de cada ferramenta MCP, o Pi lhe dá uma única ferramenta que executa scripts curtos de JavaScript em um ambiente isolado QuickJS, sem sistema de arquivos, rede ou temporizadores próprios.

A documentação do Codemode resume: "Only the script's output reaches the model, so a script can run calls in parallel and filter large results before the model sees them." O changelog do Pi 1.0 afirma que o Codemode agora usa cerca de 40% menos tokens de prompt, com uma requisição do GPT-5.6 caindo de cerca de 5,300 para 3,300 tokens. Cada servidor MCP tem uma configuração de exposição:

• codemode (padrão): as ferramentas só podem ser chamadas a partir de scripts do Codemode.
• deferred: as ferramentas só são declaradas depois que um tool_search as encontra.
• direct: as ferramentas são carregadas como as embutidas, do jeito que a maioria das harnesses faz.
• hidden: registradas, mas inacessíveis, útil para ferramentas do tipo delete_*.

A configuração fica em ~/.pi/agent/mcp.json ou no .pi/mcp.json de um projeto, no mesmo formato mcpServers do Claude Desktop e do Cursor, então você pode colar entradas existentes. Se você vem das ferramentas MCP do Claude Code, a principal mudança mental é que o modelo escreve código para chamar ferramentas em vez de chamá-las uma a uma.

Isso foi uma traição aos minimalistas? A resposta de Mario no Hacker News: "All of these features are still entirely optional and the only thing I could think of that could be considered "bloat" is the additional few megabytes for the QuickJS WASM blob." A explicação de Armin foi mais pragmática:

"we look at what the models are doing. They are trained on their respective harnesses and we're not here to fight their behavior."

the_mitsuhiko, Hacker News

O Pi 1.0 também adicionou carregamento adiado de ferramentas, aquecimento de cache para modelos da Anthropic, suporte de extensões a "modelos virtuais" (uma demo planeja com o Claude Opus e implementa com o GPT) e tornou o modo de tela cheia o padrão. O tópico do Pi 1.0 chegou a 1,686 pontos no Hacker News, cerca de três vezes mais que qualquer discussão anterior sobre o Pi.

Quatro formas de rodar

O Pi não é só uma janela de chat no terminal. O mesmo agente e motor de sessões rodam em quatro modos:

O SDK é como o OpenClaw e outros produtos se constroem sobre o Pi, e é a mesma ideia do SDK do Claude Code para agentes de programação personalizados. O modo print é a estrela discreta: é assim que os usuários do Pi simulam subagentes (o Pi chama pi --print pelo bash) e como ligam o Pi a automações no estilo Claude Code.

Em 1º de outubro, a Earendil também lançou o Pi Durable, uma biblioteca experimental com licença MIT para "long-running, durable, and malleable agents that can run anywhere." Ela grava um ponto de controle a cada passo para que uma execução sobreviva a uma falha, deixa várias pessoas se conectarem a uma mesma conversa e guarda o estado do app, como tickets ou planos, junto à transcrição. Ela "does not replace the Pi coding agent", e não é um produto hospedado. Seu gancho de aprovação de exemplo pergunta no Slack antes de uma ferramenta deploy rodar, e a Earendil diz que um bot de Slack e um bot de triagem do GitHub feitos com ela estão a caminho. Guarde isso para a seção de suporte abaixo.

O agente de programação Pi é seguro?

Esta é a linha da própria documentação de segurança do Pi, que eu leria duas vezes: o Pi "can read, change, and execute files with the permissions of the account that started it, and it does not ask for approval before every tool call."

Esse é o famoso padrão YOLO, e é uma postura, não um descuido. Mario chamou as proteções de outros agentes de "mostly security theater" em seu post de design, argumentando que, quando um agente pode escrever e executar código, uma caixa de confirmação não adianta muito. A documentação concorda e acrescenta que "watching the transcript, using project trust, and reviewing changes do not create a security boundary." A recomendação é rodar o Pi dentro de um contêiner, uma VM ou um ambiente isolado, e há receitas documentadas para Docker, Docker Sandboxes, NVIDIA OpenShell e a micro-VM Gondolin.

Novos usuários ainda se surpreendem:

"I love Pi, but minimal mean minimal. I realized it when it rm -f /tmp/somefile.log without asking for permission."

u/mantafloppy, Reddit r/LocalLLaMA

E a solução caseira tem falhas. Outro comentarista no mesmo tópico apontou que a extensão de permissões de exemplo "blocks rm -rf, but not rm -fr which does the exact same thing" (u/GalladeGuyGBA). Essa é a verdade honesta sobre proteções baseadas em padrões, e é exatamente por isso que a documentação do Pi empurra você para um ambiente isolado de verdade.

Mais três padrões que vale conhecer:

1. Confiança no projeto. A configuração em nível de projeto (.pi/settings.json, .pi/mcp.json, extensões e skills do projeto) só é carregada depois que você aprova a pasta. AGENTS.md e CLAUDE.md são carregados de qualquer forma.
2. Telemetria. O relato anônimo de instalação e atualização vem ativado por padrão (enableInstallTelemetry: true); desative com PI_TELEMETRY=0. As análises são opcionais. --offline interrompe as chamadas de rede automáticas.
3. Cadeia de suprimentos. O Pi é instalado pelo npm, e seus pacotes também. Um usuário do Reddit disse que sua VM de trabalho foi comprometida quando uma dependência transitiva foi sequestrada durante uma janela de atualização npm i -g de cerca de 30 minutos. O README agora recomenda o instalador fixado pi.dev/install.sh, que fixa todas as dependências.

Minha opinião: rode o Pi em um contêiner para qualquer coisa sem supervisão, instale pacotes como instalaria qualquer código npm e mantenha suas expectativas de avisos de permissão em zero. Se sua equipe precisa de avisos de aprovação por padrão, o modelo de permissões do Claude Code vai parecer mais seguro de fábrica.

Quanto custa o agente de programação Pi?

O Pi em si é gratuito. Não há preço por usuário, plano pago nem página de preços, porque a harness com licença MIT é o produto inteiro. O que você paga é o modelo por trás, e o Pi oferece três formas de trazer um.

Duas ressalvas. Primeiro, o changelog do Pi diz que o Pi avisa que "Anthropic third-party usage draws from extra usage and is billed per token" quando você entra com uma assinatura do Claude, então não presuma que seu plano Max cobre o Pi como cobre o Claude Code. Meu guia de preços do Claude Code explica como esses planos medem o uso. Segundo, os logins do Gemini CLI e do Antigravity do Google foram removidos na versão 0.71.0 (30 de abril de 2026), então o Gemini agora precisa de uma chave de API ou do Vertex AI.

Onde o Pi mostra valor é na eficiência de tokens. Como o prompt de sistema é tão pequeno, o cache de prompt funciona bem e cada turno envia menos. Um benchmark da Databricks em uma base de código de vários milhões de linhas, relatado pela Earendil, concluiu que "simple harnesses like Pi performed best" nas suas cargas de trabalho, com o Pi enviando cerca de três vezes menos contexto por turno.

Trate isso como um dado próximo do fornecedor, não como verdade absoluta; a Earendil cita um estudo que favorece o seu produto. Mas usuários individuais relatam a mesma direção. Um comentarista do Hacker News fez testes de tokens e descobriu que "both pi and my own 3code used 4x fewer tokens than Claude Code, while opencode used 2x fewer tokens than Claude Code." Outro disse que sessões inteiras de profiling e refatoração terminam "in <20k tokens." No ranking mais antigo do Terminal-Bench 2.0 (dezembro de 2025), o Pi com Claude Opus 4.5 ficou em #7 com 49.8%, à frente do Claude Code com Sonnet 4.5 em #18 com 40.1%.

O que os desenvolvedores dizem sobre o Pi

Os elogios são consistentes entre plataformas: prompt pequeno, baixo uso de tokens, transparência e um agente que você pode moldar. O endosso individual mais forte vem do X:

"Pi is the best agent harness and more importantly framework we have right now. The stats are stunning: - highest cache hit rate - lowest latency - highest performance - smallest bundle - cleanest code - cheapest cache + tiny system prompt over months adds up. Try it"

0xSero, X

Quem usa modelos locais gosta dele por um motivo fácil de ignorar. Um prompt de sistema enorme leva minutos para ser pré-processado em um notebook, e o do Pi não:

"Love pi. I tried to run some local models and pi was the only one that actually worked decently because it didn't have a gargantuan system prompt that would take minutes to prefill on my scrawny ass laptop."

FacelessJim, Hacker News

Outros adoram que ele sai do caminho enquanto os fornecedores continuam mudando suas ferramentas:

"The result is that the tool gradually morphs into the thing I need rather than me having to adapt myself to whatever new thing Anthropic or OpenAI comes up with."

unknownfuture, Hacker News

A crítica é igualmente consistente, e justa. A reclamação mais comum é que "tudo é um plugin" significa fazer trabalho de configuração que outros agentes fazem por você:

"Need to set the reasoning effort? Install pi-reasoning. Need subagents? Install pi-subagents. Need permission gating? Install one of the permission extensions (otherwise the agent can do everything)."

mixermachine, Hacker News

O melhor resumo em uma linha que encontrei veio de um tópico comparando o Pi com o OpenCode: "Pi vs opencode for example is like gentoo vs macos." No Reddit, o conselho para quem chega é resistir a instalar tudo no primeiro dia. Como disse um usuário do r/PiCodingAgent: "Pi actually works pretty well out of the box." Quem quer tudo incluído costuma ser apontado para o fork oh-my-pi ou para o OpenCode.

Agente de programação Pi vs Claude Code

Como a maioria chega ao Pi vindo do Claude Code, aqui vai a comparação lado a lado do que realmente muda o seu dia.

Minha leitura: se você usa principalmente modelos Claude e quer proteções, um conjunto de recursos estável e um único fornecedor para cobrar, fique com o Claude Code. Se você troca de modelo com frequência, se importa com tokens, roda modelos locais ou quer ser dono de cada linha que o agente vê, o Pi é a ferramenta mais interessante, e o lançamento 1.0 tornou a adoção bem mais fácil. Para um panorama mais amplo, incluindo Cursor e GitHub Copilot, meu resumo de assistentes de programação com IA é o melhor ponto de partida.

Você deveria construir um agente de suporte sobre o Pi?

É uma ideia razoável. O Pi tem um SDK, um modo RPC e agora o Pi Durable, cujos próprios exemplos falam de bots de Slack, ganchos de aprovação e bots de triagem. Os modelos estão mais baratos do que nunca. Por que não ligar o Pi ao seu helpdesk e chamar isso de agente de suporte?

Porque a harness é a parte menor do trabalho. Eis como vejo a divisão:

Um agente de suporte precisa de uma conexão de mão dupla com o seu helpdesk (ler o ticket, etiquetar, responder, escalar), de uma forma de manter sincronizados sua central de ajuda, suas macros e seus tickets anteriores à medida que mudam, de regras sobre o que ele pode fazer sem um humano e de um jeito de testá-lo em tickets reais do passado antes que fale com um cliente. Esse último passo é o que eu nunca pularia. A eesel aprendeu isso do jeito difícil, vendo um bot de tom confiante dar respostas erradas por dias antes de alguém notar, e é por isso que todo lançamento da eesel hoje é simulado primeiro com tickets históricos.

Vejo a tentação de construir por conta própria também do outro lado. Vários clientes da eesel, incluindo uma empresa de RA e tecnologia de construção e uma marca de beleza DTC, saíram para construir diretamente sobre a API do Claude. E as equipes que ficam costumam dizer o mesmo. Um líder de engenharia da GENERAL BYTES, fabricante de caixas eletrônicos de Bitcoin, explicou por que escolheram comprar em vez de construir:

"We could try to write our own LLM application but we didn't want to invest our time into that. We wanted something that we would not have to maintain."

Então minha resposta: construa sobre o Pi se sua equipe gosta de ser dona de toda a stack e tem tempo para acompanhar um projeto que lança versões de correção quase todo dia. Se o objetivo é ter tickets respondidos, e não um framework para manter, contrate o colega de IA e deixe o Pi fazer o que ele faz muito bem: escrever código.

Experimente a eesel

O Pi é a harness; a eesel é o funcionário. A eesel é uma plataforma de colegas de IA onde você contrata colegas prontos para trabalhar em tarefas específicas. Para suporte, esse é o colega de IA para helpdesk: ele se conecta em minutos ao Zendesk, Freshdesk, Gorgias e Slack, aprende com seus tickets anteriores e sua central de ajuda, e você pode simulá-lo no histórico dos seus próprios tickets antes que ele responda a um único cliente. Se o que você precisa é de conteúdo em vez de tickets, a mesma plataforma tem um colega redator de blog com IA.

A parte que os usuários do Pi vão gostar: você não precisa sair do terminal. A CLI da eesel opera o mesmo colega e o mesmo workspace do painel, "another way in, not a separate copy." npx @eesel/cli init configura um agente sem precisar de conta, eesel integrations connect zendesk conecta seu helpdesk (uma pessoa aprova dentro do Zendesk), eesel instructions edita as regras permanentes do agente em texto simples, eesel approvals list mostra ações aguardando um humano e eesel activity permite ler cada execução. Todo comando imprime JSON e aceita --dry-run, e os erros voltam com um campo hint, exatamente o que um agente de programação precisa para operar uma ferramenta por conta própria.

A documentação da eesel cita Claude Code, Cursor e Codex, mas nada impede o Pi de fazer o mesmo trabalho: ele pode executar a CLI pela ferramenta bash, ou se conectar ao servidor MCP que todo workspace da eesel expõe (eesel mcp token imprime a URL e um token de 30 dias), agora que o Pi 1.0 fala MCP. Configurações sem interface usam EESEL_API_URL, EESEL_API_TOKEN e EESEL_AGENT_ID. Meus guias sobre uma CLI de agente de IA e uma CLI para atendimento ao cliente aprofundam o assunto.

Você pode começar no plano gratuito com 100 créditos e sem cartão. Os planos pagos de colegas começam em $299 por mês por 500 créditos, e um ticket ou chat é um crédito, não importa quanto tempo dure. Os comandos de configuração e observação da CLI são gratuitos; só o chat é cobrado. É o caminho mais curto se você quer tickets resolvidos, e você ainda pode deixar o Pi fazer a digitação.