Tutorial Oh My Pi: crie um app completo com o Grok como seu agente de código

Por que usar o Oh My Pi?

Um bom agente de codificação precisa de duas coisas: um modelo agentivo forte e um bom “arnês” de código.

O modelo fornece a inteligência. Para este tutorial, usamos o Grok 4.6, que a xAI construiu para código, agentes de longa duração e trabalho em múltiplas etapas em bases de código inteiras. Ele suporta janela de contexto de 500 mil tokens, entrada de imagem, function calling, execução de código e busca na web.

Mas até o melhor modelo fica limitado se o arnês só deixa ler e escrever texto. Para agir como um desenvolvedor de verdade, o modelo precisa:

• Inspecionar um repositório e editar arquivos com confiança
• Executar comandos e rodar testes
• Ler diagnósticos e depurar falhas
• Buscar documentação e verificar se as mudanças realmente funcionam

É isso que o OMP oferece: integração com LSP, depurador de verdade, execução persistente de código, navegador e ferramentas web, integração com GitHub, memória e subagentes em paralelo. Juntos com o modelo, formam o ciclo agentivo completo:

Planejar → inspecionar → editar → executar → depurar → testar → verificar

O modelo decide o que fazer e o OMP fornece as ferramentas para realmente fazer. E como o OMP suporta mais de 60 provedores de IA, você não fica preso ao Grok. O mesmo fluxo funciona com Grok, Claude ou outro modelo.

Instale o Oh My Pi

Oh My Pi é um fork do agente de código open source Pi, criado pela Stencil Labs, e rapidamente se tornou um dos agentes de codificação em terminal mais populares, com mais de 34 mil estrelas no GitHub. Foi feito para desenvolvedores que querem um ambiente pronto para codar sem perder tempo montando e configurando uma stack de agente sob medida.

O OMP funciona em Linux, macOS e Windows.

No Linux ou macOS, rode:

curl -fsSL https://omp.sh/install | shTecnologia

No Windows PowerShell:

irm https://omp.sh/install.ps1 | iexTecnologia

Você também pode instalar globalmente com Bun (versão 1.3.14 ou superior):

bun install -g @oh-my-pi/pi-coding-agentTecnologia

Se o comando omp não for encontrado após a instalação, reinicie o terminal ou verifique no instalador onde o binário foi salvo.

Depois, confirme a instalação:

omp --versionTecnologia

Por exemplo:

omp/18.0.6Tecnologia

Se aparecer um número de versão, o OMP foi instalado corretamente e o comando omp está pronto para uso.

Configure o acesso SpaceXAI

Para usar o Grok com o Oh My Pi, você tem duas opções.

Se você só está testando o modelo ou acompanhando este tutorial, recomendo usar a API da xAI. Crie uma conta em https://console.x.ai/, adicione um pequeno crédito pré-pago e gere uma chave de API. A xAI desconta o uso diretamente do saldo, o que facilita controlar quanto você gasta.

Se pretende usar o Grok para codar com frequência, pode fazer mais sentido assinar o SuperGrok. O OMP suporta o SuperGrok diretamente via OAuth do SpaceXAI, então você pode conectar sua assinatura usando /login em vez de pagar cada requisição à API separadamente.

Para este tutorial, vamos usar a API por ser mais fácil de testar e controlar o custo.

Crie sua chave de API no console do desenvolvedor SpaceXAI e guarde-a com segurança. O OMP procura automaticamente a variável de ambiente XAI_API_KEY.

No Linux ou macOS:

export XAI_API_KEY="your-xai-api-key"Tecnologia

Para manter após reiniciar o terminal:

echo 'export XAI_API_KEY="your-xai-api-key"' >> ~/.bashrc
source ~/.bashrcTecnologia

No Windows PowerShell:

$env:XAI_API_KEY="your-xai-api-key"Tecnologia

Você pode conferir os modelos Grok disponíveis com:

omp models xaiTecnologia

Inicie o Oh My Pi com o Grok

Crie um novo diretório para testar o agente de código:

mkdir grok-pi-demo
cd grok-pi-demoTecnologia

Inicialize um repositório Git para o OMP rastrear as mudanças que fizer:

git initTecnologia

Agora inicie o Oh My Pi:

ompTecnologia

No primeiro uso, o OMP pode abrir um assistente rápido para configurar provedores, busca na web e a interface. Você também pode rodar omp setup a qualquer momento para reabrir.

Como já configuramos a variável de ambiente XAI_API_KEY, você não precisa entrar novamente na xAI. Pressione Esc quando terminar a configuração de provedores.

Se você estiver usando a assinatura SuperGrok em vez de créditos de API, selecione xAI Grok OAuth (SuperGrok ou X Premium+) na tela de login.

Quando o OMP abrir, digite:

/modelTecnologia

Selecione xAI na lista de provedores e escolha:

grok-4.6Tecnologia

Para usar o Grok 4.7 mais novo, selecione grok-4.7 aqui. O resto do tutorial permanece igual.

O OMP também mostra informações úteis do modelo, como janela de contexto, preços, suporte a reasoning e recursos de visão.

Agora você tem o Grok rodando dentro do Oh My Pi como um agente de codificação no terminal. A partir daqui, ele pode usar as ferramentas integradas do OMP para inspecionar arquivos, modificar código, executar comandos, rodar testes, depurar problemas e tocar tarefas maiores de desenvolvimento.

Explore os recursos nativos do Oh My Pi

O Oh My Pi vem com 31 ferramentas integradas e suporte a mais de 60 provedores de IA, então a maior parte dos fluxos de codificação funciona sem instalar plugins extras ou servidores MCP.

Alguns dos recursos nativos mais úteis incluem:

• Gerenciamento de arquivos: Ler, criar, editar, buscar e modificar arquivos de forma estrutural.

• Acesso ao terminal: Executar comandos de shell e gerenciar processos diretamente pelo agente.

• Execução de código: Rodar sessões persistentes de Python e JavaScript.

• Integração com LSP: Navegar por definições, encontrar referências, renomear símbolos, ver diagnósticos e aplicar ações de código.

• Depurador: Depurar aplicações em Python, Go, C/C++ e outras suportadas via integrações DAP.

• Busca na web: Pesquisar documentação, GitHub, Stack Overflow, Reddit, registries de pacotes, artigos acadêmicos e a web em geral.

• Automação de navegador: Abrir e interagir com sites por um navegador baseado em Chromium.

• Subagentes: Dividir tarefas maiores entre múltiplos agentes trabalhando em paralelo.

• Ferramentas do GitHub: Trabalhar com repositórios, issues, pull requests, busca de código e GitHub Actions.

• Memória: Armazenar e recuperar informações úteis do projeto entre sessões.

• Compreensão de imagens: Inspecionar screenshots, diagramas e outras imagens locais.

• Geração de imagens: Gerar ou editar imagens usando provedores de IA compatíveis.

• Texto para fala: Gerar fala usando xAI Grok Voice.

• Arquivos remotos: Ler arquivos em máquinas remotas via caminhos ssh://.

• Gerenciamento de sessão: Criar checkpoints, voltar, ramificar, retomar e gerenciar sessões mais longas.

• Orquestração de agentes: Palavras-chave como orchestrate e workflowz no seu prompt coordenam múltiplos subagentes para tarefas complexas.

Algumas dessas ferramentas — como GitHub, memória, geração de imagens, texto para fala e checkpoints — vêm desativadas por padrão. Você pode ativá-las nas configurações do OMP.

Em outras palavras, o modelo faz muito mais do que gerar código. Com o Oh My Pi, ele pode buscar na web, entender uma codebase, editar arquivos, executar comandos, depurar erros, lembrar o contexto do projeto e coordenar múltiplos agentes — tudo pela mesma interface no terminal.

Crie um projeto com Oh My Pi e Grok

Em vez de testar com uma pergunta simples, vamos passar um projeto completo e ver como o Grok e o Oh My Pi lidam com planejamento, implementação, testes e iteração.

Primeiro, mude o OMP para o modo de planejamento (/plan no momento da escrita):

/planTecnologia

Depois, insira o seguinte prompt:

Build a simple Hospital Management System in Python.

Use Streamlit for the web interface and SQLite for storing data. Keep the project lightweight and easy to run locally.

The app should let hospital staff register patients, add doctors, schedule appointments, admit and discharge patients, and view available beds.

Create a dashboard showing total patients, doctors, appointments, admitted patients, and available beds.

Use a clean sidebar for navigation, simple forms and tables, and realistic sample data.

Organize the Python code properly, create the database automatically, add basic validation, and make all CRUD operations work.

Install any required dependencies, run the application, test the main workflows, and fix any errors.Tecnologia

Revise o plano

Antes de escrever código, o Grok usou as ferramentas integradas do OMP para pesquisar documentação relevante, checar informações atuais sobre Streamlit e o ecossistema Python, inspecionar os requisitos e pensar em como a aplicação deveria ser estruturada.

Depois, ele produziu um plano de implementação detalhado, dividido em seções. O OMP torna o plano interativo, então você pode navegar entre seções, inspecionar decisões específicas em mais detalhes e fazer ajustes antes de permitir que o agente mexa no projeto.

Quando estiver satisfeito, aprove o plano e deixe o Grok começar a construir.

Deixe o Grok construir e testar o app

Depois de aprovar o plano, a implementação em si foi surpreendentemente direta. O Grok criou a estrutura do projeto, a camada de banco de dados, a interface em Streamlit, dados de exemplo e o CRUD; depois instalou as dependências e testou a aplicação.

A primeira versão funcional levou menos de cinco minutos para ser construída e testada.

É aqui que ter um arnês de código de verdade faz diferença. O Grok não estava apenas gerando um bloco de Python e me devolvendo. Ele criou arquivos, rodou a aplicação, inspecionou erros, fez correções e continuou até o projeto estar no ar.

Itere sobre a UI

A primeira versão funcionou, mas eu não gostei do visual padrão do Streamlit. Ficou com cara de app genérico do Streamlit.

Então pedi ao agente as mudanças desejadas — tema, layout do dashboard, hierarquia visual e como apresentar as informações. O Grok modificou o projeto existente, sem refazer tudo do zero.

O resultado final foi um Sistema de Gestão Hospitalar caprichado, com gestão de pacientes, cadastro de médicos, consultas, internações, controle de leitos e relatórios.

O processo também mostra o valor dos agentes de codificação: você começa com uma versão funcional, revisa e segue refinando design e funcionalidades com instruções simples de follow-up.

Uma nota sobre custos

Há um ponto negativo importante: usar o Grok via API pode sair caro para fluxos agentivos de codificação.

Neste projeto, o dashboard de uso do SpaceXAI mostrou US$ 11,84 no total, com cerca de 19,4 milhões de tokens processados em 938 requisições à API. A maior parte veio de planejamento, busca na web, edição de arquivos, execução de ferramentas, testes do app e refinamento da UI.

Para testes ocasionais, créditos de API ainda são úteis porque você controla exatamente quanto gasta. Mas se você codar todo dia ou construir projetos maiores, a assinatura SuperGrok tende a ser a melhor opção — especialmente quando fluxos agentivos geram centenas de requisições em uma única sessão.

O Grok entregou resultados excelentes, mas este teste também mostrou que, com agentes de código, custo e uso de tokens importam tanto quanto a qualidade do modelo.

Considerações finais

Uma coisa que está ficando clara com agentes de codificação é que o modelo e o arnês de código não precisam vir da mesma empresa. O arnês padrão de um modelo nem sempre é a melhor forma de usá-lo, e os devs estão cada vez mais combinando modelos fortes como Claude ou Grok com agentes alternativos e ferramentas em terminal que se encaixam melhor no seu fluxo.

O problema é que montar seu próprio setup pode ficar tedioso rápido. Você começa instalando servidores MCP, adicionando skills, configurando plugins, conectando ferramentas e mantendo tudo por conta própria.

É isso que eu gosto no Oh My Pi. Ele é um agente “batteries-included”, com a maioria desses recursos já embutidos. Você instala, conecta seu provedor ou assinatura, escolhe um modelo e começa a codar. Sem gastar horas montando o agente antes de realmente usá-lo.

O Grok funcionou muito bem com o OMP e gerou um aplicativo robusto, mas o custo pela API foi maior do que eu esperava. Para testes ocasionais, créditos de API são ok. Se eu usasse o Grok diariamente para codar, pessoalmente eu iria de SuperGrok com OMP.

No fim, o interessante não é só quem tem o melhor modelo de código, e sim encontrar a melhor combinação entre modelo e arnês para o seu jeito de trabalhar.