seu Vibe CoderO guia definitivo do Agent Pi para devs brasileiros — um harness minimalista para codificar com agentes direto do terminal. Aprenda na prática como a ferramenta funciona, quais comandos usar e como adaptar o Pi ao seu fluxo de vibe coding, não o contrário.
Pi é um harness minimalista de codificação no terminal. A proposta é simples: o Pi se adapta ao seu workflow — não o contrário. Personalize com extensões, skills, templates de prompt e temas, empacote tudo como pacotes Pi e compartilhe via npm ou git.
O Pi vem com defaults poderosos, mas deliberadamente pula features como sub-agentes e modo plan. A ideia é você construir o que precisa — ou instalar um pacote que já faz do jeito que você quer. Sem overhead forçado, sem caixas-pretas.
São quatro modos de uso: interativo (TUI completo), print/JSON (scripts e pipelines), RPC (integrações externas) e SDK (embarcado em apps). Veja o OpenClaw como exemplo real de integração.
[ LER A DOCUMENTAÇÃO ]O Pi não é um produto selado. Se você precisa de um comando, ferramenta, provedor, workflow ou ajuste de UI — peça pro Pi construir. Ele se customiza na hora.
Mande o Pi manipular ele mesmo no lugar, dê /reload,
e siga adiante. Se achar útil, compartilhe com os outros.
Anthropic, OpenAI, Google, Azure, Bedrock, Mistral, Groq, Cerebras, xAI, Hugging Face,
Kimi For Coding, MiniMax, OpenRouter, Ollama e mais. Autentique via chave API ou OAuth.
Adicione provedores e modelos próprios via models.json ou extensões.
Sessões viram árvores. Use /tree pra
voltar em qualquer ponto e continuar dali. Todos os ramos vivem em um único arquivo.
Filtre por tipo de mensagem, marque bookmarks.
Exporte pra HTML com /export,
ou suba num GitHub gist com /share
e ganhe uma URL renderizada pra mandar pro time.
O system prompt enxuto e a extensibilidade do Pi te dão controle real sobre o que entra na janela de contexto e como ela é gerenciada.
Carregadas no início a partir de ~/.pi/agent/, pastas parent e a pasta atual.
Substitua ou estenda o system prompt padrão por projeto, sem mexer no core.
Auto-resume mensagens antigas perto do limite. Customize via extensão: por tópico, code-aware, ou modelo separado.
Pacotes de capacidade com instruções e ferramentas, carregados sob demanda. Sem estourar o prompt cache.
Prompts reutilizáveis como arquivos Markdown. Digite /nome pra expandir.
Extensões injetam mensagens antes de cada turn, filtram histórico, implementam RAG ou memória de longo prazo.
Mande mensagens enquanto o agente trabalha. Você escolhe se interrompe ou espera.
Entregue após o tool atual terminar — interrompe os tools restantes. Pra quando você percebe que o agente está indo no caminho errado.
Espera o agente terminar tudo antes de processar. Pra deixar enfileirada a próxima pergunta sem atrapalhar.
Use o Pi do jeito que faz sentido pro seu fluxo — do TUI completo até embarcado dentro de outros apps.
A experiência TUI completa, com histórico em árvore, contexto e tools.
Para scripts e pipelines. Use --mode json pra streams de eventos.
Protocolo JSON sobre stdin/stdout pra integrações não-Node. Veja docs/rpc.md.
Embarque o Pi nos seus apps. Veja OpenClaw como exemplo real.
Embrulhe extensões, skills, prompts e temas como pacotes Pi. Instale do npm ou git — funciona igual ao gestor de pacotes que você já conhece.
Não quer construir? Peça pro Pi fazer por você, ou instale um pacote que já resolve do jeito que você precisa. Veja os 50+ exemplos da comunidade.
[ EXPLORAR PACOTES ]Construa CLIs com READMEs (veja Skills), ou crie uma extensão que adicione suporte MCP. Por quê?
Gere instâncias Pi via tmux, ou construa o seu próprio com extensões — ou instale um pacote que faça isso do seu jeito.
Rode em container, ou construa seu próprio fluxo de confirmação com extensões alinhadas à sua segurança.
Use prompts customizados para qualquer planejamento que você queira — sem caminho único forçado.
Skills geram TODOs como markdown ou JSON — versionável, diffável, reutilizável entre sessões.
Quando o Pi faz tarefas demoradas, ele bloqueia. Quer paralelizar? Use tmux ou crie uma extensão.
Developer, coach e speaker. Criou o Agent Pi com uma filosofia clara: ferramentas simples, previsíveis e com controle total nas mãos de quem usa.
Autor de sete projetos em produção usando sua própria API unificada de LLM. Construiu o Pi do zero — do harness ao TUI — porque queria um agente que some quando você quer pensar, e aparece quando você precisa.
O projeto vive na organização Earendil, cofundada com Armin Ronacher — criador do Flask, Jinja e Click.
[ LER O POST DO MARIO ]Agent Pi é um harness open-source (licença MIT) de codificação no terminal, criado por Mario Zechner. Permite usar agentes de IA diretamente no terminal com controle total do workflow. O projeto possui mais de 53.000 estrelas no GitHub e é mantido pela organização Earendil.
Via curl: curl -fsSL https://agentpi.br/install.sh | sh
Via npm: npm install -g @agentpi-br/cli
Via brew: brew install agentpi-br/tap/pi
Documentação completa: pi.dev/docs/latest
O Pi suporta 15+ provedores: Anthropic (Claude), OpenAI (GPT), Google (Gemini), Azure, AWS Bedrock, Mistral, Groq, Cerebras, xAI (Grok), Hugging Face, Kimi, MiniMax, OpenRouter, Ollama (modelos locais) e provedores customizados via models.json.
O Agent Pi é open-source (MIT) e suporta 15+ provedores de LLM com extensibilidade total via pacotes npm/git. Claude Code é o CLI oficial da Anthropic, focado exclusivamente no modelo Claude. O Pi prioriza minimalismo e controle do dev; o Claude Code prioriza integração profunda com o ecossistema Anthropic.
Sim. O Agent Pi é 100% open-source sob licença MIT. Você paga apenas pelos tokens dos provedores de IA que usar. Código disponível em github.com/earendil-works/pi.
Vibe coding com Agent Pi é a prática de codificar usando agentes de IA no terminal, delegando tarefas como refatoração, geração de testes e manipulação de arquivos ao agente, enquanto o dev mantém controle total — sem sub-agentes ocultos, sem popups de permissão, com histórico em árvore para navegar entre ramos da sessão.
Grupo Agent Pi BR — discuta, tire dúvidas e compartilhe em português.
Canal Agent Pi BR — novidades e atualizações da ferramenta.