Oh My Pi vs Pi: o fork, as diferenças e qual executar

O Oh My Pi é um fork radical do Pi, não um rival que cresceu ao lado dele — o código fluiu de Pi → Oh My Pi, os dois projetos estão ativos hoje e agora otimizam coisas opostas. O Pi é um harness de terminal deliberadamente minimalista que você estende em TypeScript. O Oh My Pi é a mesma linhagem reconstruída como uma superfície de programação completa, com LSP, depurador, subagentes e ferramenta de navegador integrados. Ambos têm licença MIT e custam $0 para instalar, portanto a decisão envolve fluxo de trabalho, modelo de execução e formato de configuração — não uma taxa de licença.

Primeiro, os nomes, porque três deles se confundem. Pi aqui significa o harness de agente em pi.dev, publicado pela Earendil Works a partir de earendil-works/pi. Não é o Pi da Inflection AI (pi.ai), a moeda Pi Network nem o Raspberry Pi. Oh My Pi significa o agente em omp.sh, de can1357/oh-my-pi, cujo binário é omp — não as padarias de tortas que dominam uma busca por essa expressão, nem Oh My Zsh ou Oh My Posh, apesar do eco nos nomes. E pi-mono não é um terceiro produto: é o antigo nome do repositório do Pi. github.com/badlogic/pi-mono agora retorna 301 para earendil-works/pi, embora a documentação de terceiros ainda use o caminho antigo — a página oficial de integração do Pi da DeepSeek literalmente está em /agent_integrations/pi_mono/.

Vale esclarecer a direção do fork, porque as buscas ocorrem nos dois sentidos e a resposta não é simétrica. O README do Oh My Pi diz no próprio cabeçalho que ele é um “Fork of Pi by @mariozechner”, com um link para a URL anterior à renomeação. O GitHub informa fork: false e parent: null para ele, porque este é um fork de código-fonte, e não criado pelo botão de fork — portanto, a API não informará isso. O repositório ainda contém docs/porting-from-pi-mono.md, uma lista de verificação de merge cujo Last Sync Point registrado é o commit b21b42d, datado de 22 de março de 2026. Esse marcador é a única evidência de divergência disponível externamente; não é possível confirmar nesta página se ocorreu uma sincronização posterior não registrada.

Oh My Pi vs Pi: qual você deve escolher?

Cinco eixos decidem isso — independentemente da direção pela qual você chegou à comparação — e apenas um deles diz respeito aos recursos.

• Fluxo de trabalho. Escolha o Pi se quiser um núcleo pequeno e pretender escrever por conta própria as partes ausentes. Até a atualização da documentação em 22 de setembro de 2026, a documentação de uso própria afirmava que ele “intencionalmente não inclui MCP integrado, subagentes, pop-ups de permissão, modo de planejamento, listas de tarefas ou bash em segundo plano” e indicava extensões, pacotes, contêineres e tmux. A atualização removeu essa frase, e a v0.99.0 tornou o MCP uma extensão integrada carregada por padrão; subagentes, modo de planejamento, listas de tarefas e prompts de aprovação continuam sendo extensões na v0.99.2. Escolha o Oh My Pi se quiser esses recursos integrados desde o primeiro dia e não quiser manter uma extensão.
• Permissões e modelo de execução. Nenhum dos padrões é o seguro, portanto escolha com base no modo de falha com o qual você consegue conviver. O Pi não tem sistema de permissões e é explícito sobre isso. O Oh My Pi tem um sistema real de três níveis e vem configurado por padrão como yolo. Se você precisa de prompts por ferramenta, o Oh My Pi pode fornecê-los após uma linha de configuração; o Pi não pode fornecê-los sem uma extensão.
• Limites de protocolo e plano. Se sua rota de modelo for um endpoint de terceiros compatível com OpenAI ou Anthropic, ambos conseguem acessá-la, mas o Oh My Pi documenta nove dialetos de rede, enquanto o Pi documentava quatro até a atualização da documentação em 22 de setembro de 2026, além de adicionar uma rota por variável de ambiente que o Pi não possui. A diferença de dialetos é menor no código do que no papel: o código-fonte do Pi na v0.99.2 encaminha o api de um provedor personalizado para qualquer uma de dez implementações integradas, seis delas nunca documentadas para esse uso. Se sua rota for uma assinatura OAuth — Claude Pro/Max, Codex, GitHub Copilot — ambos os clientes a conectam por meio de /login e armazenam um token do fornecedor, que seria rejeitado por um gateway intermediário; a documentação de provedores do Oh My Pi dá esse como o motivo pelo qual uma chave models.yml substitui deliberadamente o OAuth armazenado. Não inclua os planos chineses de programação nesse grupo: o Pi lista ZAI/GLM, Kimi For Coding e os Qwen Token Plans em sua tabela de chaves de API (ZAI_API_KEY, KIMI_API_KEY, QWEN_TOKEN_PLAN_API_KEY), e o Oh My Pi os marca como plan, e não oauth, portanto são provedores comuns baseados em chave em ambos.
• Caminho de custo. O cliente é gratuito nos dois lados e nenhum deles altera sua tarifa por token. A assimetria é que o Pi tem um gateway pago de primeira parte (Radius, operado pela mesma empresa) integrado ao próprio /login, enquanto o Oh My Pi não oferece nenhuma rota hospedada — o único servidor que ele opera é o relay por trás dos links de sessão /collab, que não cobra nada.
• Custo de migração. Aproximadamente um bloco de provedor, redigitado. Os formatos e diretórios de configuração diferem — JSON em ~/.pi, YAML em ~/.omp — e nenhuma ferramenta de importação é documentada em qualquer um dos repositórios. Alguns nomes de variáveis de ambiente são compartilhados, com as ressalvas abaixo.

O que não deve decidir isso: os números de versão. O Oh My Pi foi renumerado no fork, portanto o 18.2.7 dele e o 0.86.1 do Pi são esquemas diferentes, não dezoito versões de maturidade adicional.

O que realmente difere entre eles

Lido na documentação própria dos dois repositórios em 19 de setembro de 2026: as páginas de visão geral, segurança e modelos do Pi, e as páginas de README, approval-mode e providers do Oh My Pi. As linhas de design declarado, MCP, modelo de permissões e dialetos do Pi foram verificadas novamente em 1º de outubro de 2026 com base na documentação atualizada, no README e no código-fonte do Pi na v0.99.2. As contagens de recursos na linha do Oh My Pi são alegações do próprio projeto; nenhuma metodologia foi publicada para elas, e a tabela de benchmark do README também é uma alegação do fornecedor que esta página não reproduz.

Ambos estão ativos. Nenhuma métrica determina “qual é maior”

O erro mais comum sobre este par é tratar um deles como abandonado ou substituído. Ambos enviaram código no dia desta verificação.

Números de repositórios, versões lançadas e estrelas obtidos da API do GitHub, consultada em 21 de setembro de 2026; contagens de downloads obtidas da API de downloads do npm para a semana encerrada em 16 de setembro de 2026. Não transforme nenhuma das duas colunas em um veredito sobre adoção. A comparação pelo npm, em particular, não usa bases equivalentes: a própria documentação do Pi começa com npm install -g, enquanto o README do Oh My Pi documenta curl-to-shell, Homebrew, Bun, Nix, PowerShell e mise e não fornece nenhum comando npm, de modo que o npm subestima significativamente seus números em uma magnitude que nada aqui permite medir. As estrelas favorecem o Pi; a frequência de lançamentos favorece o Oh My Pi; qualquer afirmação sobre popularidade baseada em uma única métrica estará errada em pelo menos um sentido.

Evidência neutra de terceiros de que ambos estão atuais, se você quiser isso sem métricas: a Ollama publica uma página de integração para Oh My Pi e para Pi, e a DeepSeek também publica um guia de integração de agentes para cada um — o guia do Pi ainda está arquivado no antigo caminho pi_mono. As quatro páginas responderam em 21 de setembro de 2026.

Apontando qualquer um dos dois para seu próprio endpoint

É aqui que o fork fica mais visível e onde um /v1 incorreto pode custar uma tarde. Ambos os clientes conseguem acessar um endpoint de terceiros compatível com OpenAI ou Anthropic, mas por mecanismos diferentes e com convenções de URL opostas.

O Oh My Pi tem uma rota por variável de ambiente que o Pi não possui. Seu provedor Anthropic resolve a URL base por meio de normalizeAnthropicBaseUrl($env.ANTHROPIC_BASE_URL), antes do padrão oficial, e esse normalizador remove um /v1 final — portanto, tanto https://api.kunavo.com quanto https://api.kunavo.com/v1 chegam ao mesmo host. Lido em packages/ai/src/providers/anthropic-state.ts, onde resolveDirectAnthropicBaseUrl() e o normalizador são definidos, em 19 de setembro de 2026 — a partir do código-fonte, não de uma solicitação que fizemos.

# Oh My Pi honours ANTHROPIC_BASE_URL for its built-in anthropic provider.
# normalizeAnthropicBaseUrl() strips a trailing /v1, so both forms resolve
# to the same host here. Pi ships no equivalent gateway base-URL variable.
export ANTHROPIC_API_KEY="$KUNAVO_API_KEY"
export ANTHROPIC_BASE_URL="https://api.kunavo.com"
omp

Essa rota traz uma armadilha de precedência. A ordem documentada pelo Oh My Pi coloca um models.yml apiKey na posição 2, acima do OAuth armazenado na posição 3, mas uma variável de ambiente do provedor na posição 5, abaixo dele. Portanto, se você já tiver feito login com /login na Anthropic, o token da assinatura vencerá ANTHROPIC_API_KEY e sua chave de gateway nunca será usada. Fixe a chave na configuração ou saia primeiro desse provedor.

Para um provedor nomeado, o Oh My Pi usa YAML — e aqui o /v1 volta a ser acrescentado, porque o caminho OpenAI dele anexa /chat/completions literalmente à URL base aparada.

providers:
  kunavo:
    baseUrl: https://api.kunavo.com/v1   # /v1 REQUIRED: omp appends /chat/completions
    api: openai-completions              # use anthropic-messages, and then drop /v1
    apiKey: KUNAVO_API_KEY               # env var name, a literal, or "!cmd"
    authHeader: true                     # send Authorization: Bearer <key>
    models:
      - id: claude-sonnet-5
        contextWindow: 200000
        maxTokens: 64000

Para apontar o Pi para um gateway, você tem uma rota: ~/.pi/agent/models.json. O Pi não lê ANTHROPIC_BASE_URL — uma busca de código em todo o repositório em 19 de setembro de 2026 retorna duas ocorrências dessa string exata, ambas sem substituição (uma constante do Cloudflare AI Gateway e um script de geração de modelos) — e também não há um OPENAI_BASE_URL simples. Existe uma variável de URL base, mas ela não é uma saída geral: AZURE_OPENAI_BASE_URL, listada na documentação de provedores do Pi, aponta o provedor Azure OpenAI para seu próprio recurso Azure e nada mais.

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com",
      "api": "anthropic-messages",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "contextWindow": 200000,
          "maxTokens": 64000
        }
      ]
    }
  }
}

Quanto ao sufixo, a própria documentação do Pi nunca chegou a uma definição, e você deve saber disso em vez de confiar em um único exemplo. Até a atualização da documentação em 22 de setembro de 2026, sua página de modelos mostrava um proxy anthropic-messages como https://proxy.example.com/v1 em um lugar e como https://proxy.example.com sem sufixo em outro; a atualização removeu ambos sem resolver a questão. A forma sem sufixo é a que deve ser seguida, e o raciocínio é derivado do código-fonte, não testado em runtime: o Pi não inclui nada semelhante ao normalizador do Oh My Pi que remove /v1 no caminho anthropic-messages — a única normalização descrita na documentação é específica do Azure: URLs raiz de recursos nos próprios domínios do Azure “são normalizadas para o caminho da API OpenAI” —, o padrão Anthropic integrado é https://api.anthropic.com sem /v1, enquanto o padrão OpenAI é https://api.openai.com/v1, e, para anthropic-messages, ele passa model.baseUrl diretamente ao SDK oficial da Anthropic, que acrescenta /v1/messages por conta própria. Um /v1 nesse ponto produziria /v1/v1/messages. A Kunavo documenta a mesma convenção em sua página de URL base: somente a origem para clientes no estilo Anthropic, /v1 para os no estilo OpenAI.

Mais duas limitações que vale a pena considerar no planejamento. Até a atualização da documentação em September 22, 2026, a tabela documentada do Pi listava quatro dialetos para provedores personalizados, embora o repositório inclua implementações adicionais; a atualização removeu a tabela sem indicar uma lista substituta, de modo que esses quatro continuam sendo as únicas opções que o Pi documentou para provedores personalizados. As implementações adicionais, porém, não são reservadas aos provedores integrados: o código-fonte do Pi na v0.99.2 define o tipo de api em models.json como uma string livre e o encaminha para a implementação correspondente entre as dez registradas (BUILTIN_APIS em packages/ai/src/compat.ts), portanto um provedor personalizado pode especificar bedrock-converse-stream ou google-vertex — se algum deles funciona com um endpoint de terceiros é algo não documentado e não testado aqui. E, no Oh My Pi, disabledProviders é verificado antes das credenciais — um ID de provedor incluído nessa lista desaparece silenciosamente, independentemente da chave que você forneça —, enquanto os arrays de configurações são substituídos integralmente pela camada de maior precedência, em vez de serem mesclados, de modo que uma lista no nível do projeto descarta silenciosamente a lista global. Ambos os projetos também incluem opções para contornar restrições de compatibilidade das quais você pode realmente precisar em um gateway: disableStrictTools do Oh My Pi, supportsEagerToolInputStreaming e allowEmptySignature do Pi. Não foi testado aqui se o Kunavo aceita os esquemas estritos padrão, os marcadores de cache ou o streaming antecipado de entradas de ferramentas de qualquer um dos dois clientes.

O custo real da troca

Menos do que a diferença entre os números de versão sugere, e mais do que copiar um arquivo. Não há comando de importação, conversor de sessões ou migrador de configuração documentado na árvore de documentação de nenhum dos repositórios; portanto, planeje redigitar o bloco do provedor no outro formato — JSON para YAML, ou o contrário. As credenciais também não são transferidas: o Pi as armazena em ~/.pi/agent/auth.json, enquanto o Oh My Pi mantém um armazenamento de autenticação SQLite em ~/.omp/agent/agent.db.

As variáveis de ambiente têm um alcance menor do que a ancestralidade compartilhada sugere, portanto leia isto com atenção. O Oh My Pi ainda lê os nomes prefixados com PI_ — incluindo PI_CONFIG_DIR e PI_CODING_AGENT_DIR — mas eles realocam os diretórios do Oh My Pi; assim, exportar uma delas em um perfil de shell compartilhado com o Pi faz com que ambos os clientes apontem para o mesmo caminho, em vez de tornar uma configuração portátil. O espelhamento de OMP_ para PI_ descrito em sua referência de variáveis de ambiente é ainda mais limitado: essa documentação afirma que a regra se aplica dentro de cada arquivo .env analisado e explicitamente "não a variáveis arbitrárias herdadas do processo pai". O que não será transferido de forma alguma é qualquer coisa criada para o harness: uma extensão TypeScript do Pi é escrita para a API do Pi, e aproximadamente seis meses de desenvolvimento mantido separadamente desde o marcador de sincronização de 22 de março de 2026 são exatamente onde essas APIs divergem. Teste uma extensão em vez de presumir que ela será portada.

O custo é o mesmo nos dois lados

Nenhum dos clientes cobra de você, portanto alternar entre eles altera em zero o gasto com modelos. A variável é por qual rota você compra tokens e, nesse ponto, os dois diferem de uma maneira: o Pi tem um gateway pago próprio e o Oh My Pi não. O Radius é operado pela Earendil, tem código-fonte fechado, é acessado pelo próprio /login do Pi, e sua FAQ afirma que cobra "as taxas que temos com nosso processador de pagamentos além dos preços de tabela" — uma porcentagem que não publica; portanto, não é possível calcular um total do Radius externamente. O único gateway do Oh My Pi é omp auth-gateway serve, um software hospedado por você, com a segurança do transporte delegada ao operador.

Há uma coisa a eliminar antes que ela entre no orçamento: uma assinatura Claude Pro ou Max conectada a qualquer um dos harnesses não representa uso gratuito. Até a atualização da documentação em 22 de setembro de 2026 remover a frase, a documentação de provedores do Pi dizia que o uso por harnesses de terceiros "consome uso adicional e é cobrado por token, não contra os limites do plano Claude"; o aviso exibido pelo Pi quando um modelo Anthropic é executado com autenticação de assinatura ainda diz que ele "consome uso adicional e é cobrado por token, não pelos limites do seu plano Claude" (fonte, v0.99.2). Não foi encontrada declaração equivalente na documentação do Oh My Pi, portanto não presuma que ele se comporta de maneira diferente — verifique sua própria conta.

Para a rota do gateway, eis a aritmética sobre a carga de trabalho, não sobre o cliente. Suponha um mês de trabalho contínuo do agente: 5,000,000 tokens de entrada não armazenados em cache e 400,000 tokens de saída, sem leituras ou gravações de cache e sem cobranças por imagens ou ferramentas. As tarifas são os preços atuais do catálogo da Kunavo por milhão de tokens.

Estas são estimativas ilustrativas de tokens sob as premissas acima, não custos medidos de tarefas nem um teto para uma cobrança. A coluna é idêntica para os dois clientes porque o cliente não é uma variável de preço — mas a carga de trabalho pode ser: a ferramenta task do Oh My Pi distribui subagentes em paralelo, e cada agente paralelo carrega seu próprio contexto, o que é um multiplicador de tokens de entrada que nenhuma tabela aqui pode dimensionar para você. Meça isso em uma alteração limitada antes de ampliar a estimativa.

Duas ressalvas do lado da Kunavo pertencem ao mesmo número. O valor do catálogo é um piso de cobrança, não um limite máximo: quando o upstream informa seu custo, a cobrança é o maior entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável, conforme explica o guia de cobrança. E o carregamento mínimo é $10 de crédito pré-pago — o dinheiro necessário para financiar uma conta, não uma taxa de tarefa nem uma assinatura.

A Kunavo publica um guia de configuração para cada cliente — Pi e Oh My Pi —, mas não testou nenhum deles em tempo de execução contra seu endpoint; um guia de configuração é uma referência de configuração, não um teste de compatibilidade. As duas configurações acima foram elaboradas com base na documentação e no código-fonte publicados e devem ser verificadas em sua própria máquina. Mantenha uma rota funcional disponível enquanto experimenta uma delas. Quando quiser precificar uma tarefa real, em vez de um modelo, crie uma conta na Kunavo, deposite fundos e execute uma alteração limitada no modelo que você selecionou. Se ainda estiver escolhendo um harness, em vez de um provedor, os preços do agente de programação Pi detalham as quatro rotas de cobrança do Pi, e Pi vs OpenCode compara o Pi com outro cliente que possui um guia de configuração da Kunavo publicado.

Perguntas frequentes

As árvores de documentação e os pacotes npm de ambos os repositórios foram verificados em 19 de setembro de 2026, e as afirmações sobre a URL base e a ordem das credenciais foram lidas nos arquivos-fonte indicados inline na mesma data; as métricas dos repositórios e os históricos de versões foram relidos em 21 de setembro de 2026. Após a atualização da documentação do Pi em 22 de setembro de 2026, seus exemplos de URL base de anthropic-messages, a frase sobre normalização do Azure, os valores de api documentados e a ordem das credenciais foram reverificados em 1º de outubro de 2026, com base na documentação atualizada e no código-fonte da v0.99.2. No mesmo dia, após o Pi v0.99.0 incluir MCP integrado, sua lista de recursos ausentes, a redação sobre confiança no projeto e o design declarado foram reverificados nas páginas de uso, MCP, configurações e segurança e no README, nos valores de api que seu código despacha, na linha sobre uso adicional comparada ao aviso do terminal nesse código-fonte e no índice de integrações deste site. Também em 1º de outubro de 2026, os valores de api documentados pelo Oh My Pi foram reverificados em seu docs/models.md e no esquema models.yml na v18.4.8. As tarifas da Kunavo são renderizadas a partir do catálogo atual, e cada valor em dólares aqui é uma aritmética ilustrativa de tokens. Nenhum dos clientes foi testado em tempo de execução contra a Kunavo, e nenhuma comparação de desempenho ou benchmark entre os dois projetos está implícita — não existe nenhuma que esta página pudesse citar.