App open-source para o Pi Coding Agent

O Pi não distribui modelo nenhum, o que acaba por ser o facto interessante ao executá-lo aqui: todas as credenciais de agente que o Happier guarda são credenciais que o Pi aceita. Perfis de subscrição Claude, chaves Anthropic, logins do Codex e chaves da OpenAI funcionam todos, por isso as contas que juntou numa pool porque usa o Claude Code também conseguem conduzir este — escolhidas quando a sessão começa, em vez de decididas pela última conta com que esse computador ficou com sessão iniciada.

O mecanismo merece uma frase, porque explica o que se move e o que não se move. Antes do arranque, o Happier escreve o perfil que escolheu no ficheiro de credenciais isolado do próprio Pi, na forma que o Pi espera: um início de sessão por subscrição torna-se uma credencial OAuth, um setup token ou uma chave de API torna-se uma chave. O Pi lê depois o seu próprio ficheiro e fala diretamente com o fornecedor, sem que nenhum pedido seu seja encaminhado por nada nosso. Se vários dos seus perfis servirem, a app pergunta qual em vez de escolher por si.

Não há botão de início de sessão para este, e isso é do Pi e não uma omissão: ele não expõe qualquer início de sessão interativo que o Happier possa conduzir, por isso a página do fornecedor reporta as credenciais baseadas no ambiente que esse computador já tem e fica por aí. A orientação funciona — uma mensagem enviada para um turno que já está a decorrer é aceite pelo agente em vez de ficar à espera atrás dele — enquanto escrever num terminal do fornecedor não é algo que este agente ofereça. O Pi é um fornecedor experimental no Happier, e é nesse estado que deve ser lido.

O Pi é um agente de programação em terminal do tipo “traga a sua própria chave”: não distribui um modelo, conduz o fornecedor para o qual tiver credenciais. happier pi executa-o no seu repositório com o ambiente que a sua shell já tem.

Isso encaixa na forma como o Happier funciona, porque o Happier também não guarda essas chaves. O processo do agente lê-as no seu computador, fala diretamente com o fornecedor, e a única coisa que atravessa a rede é uma transcrição encriptada a caminho dos seus próprios dispositivos.

Portanto, a forma de uma sessão do Pi é: as suas chaves, o seu computador, o seu repositório e um telemóvel no bolso que consegue ler a conversa e responder-lhe. Nada nessa lista é alugado a nós, e o relay que fica pelo meio é um que pode executar você mesmo se preferir não usar o nosso.

As aplicações iOS e Android, a aplicação de desktop para macOS, Windows e Linux, e o app.happier.dev são todos clientes sobre o processo Pi Coding Agent que corre no seu computador — não espelhos apenas de leitura. Responda a um pedido de permissão, envie a instrução seguinte, percorra o repositório, leia o diff. A transcrição é encriptada de ponta a ponta antes de sair do seu computador, por isso o servidor que a transporta guarda texto cifrado.

O Happier instala-se no computador que já guarda o seu repositório, e happier pi inicia lá o Pi Coding Agent como um subprocesso normal, no diretório para onde o apontar, com a sessão iniciada da forma como a iniciou. Não há gateway nenhum entre o agente e a Pi, nem cópia nenhuma do seu código em mais lado nenhum.

O Happier procura primeiro pi no seu PATH e executa a cópia que você instalou. Se não houver nenhuma, ele pode instalar @earendil-works/pi-coding-agent em ~/.happier/tools/providers/pi/ — um diretório próprio, não o seu prefixo global do npm. Uma cópia que você gerencia nunca é substituída nem atualizada pelas suas costas.

O guia de instalação e login da própria Pi está em github.com/badlogic/pi-mono. O Happier não o espelha, porque uma cópia das instruções de instalação de outra pessoa é uma cópia que fica desatualizada.

Referência de configuração do lado do Happier — Pi Coding Agent na documentação do Happier.

O Pi Coding Agent é um dos agentes que o Happier consegue apontar para uma credencial conectada uma única vez, em vez da conta em que aquele computador está logado. Ele aceita a Codex subscription, an OpenAI API key, a Claude subscription or an Anthropic API key.

Os serviços conectados são indexados pela credencial, não pelo agente, então o mesmo Codex subscription pode ser selecionado para qualquer agente que o aceite, em todos os computadores que você conectou — o que também é o que torna útil um pool das suas próprias contas em mais de um deles. A credencial é criptografada e descriptografada nos seus próprios dispositivos; a página da documentação traz as regras por perfil, porque quais tipos de perfil cada agente aceita é exatamente o tipo de detalhe que muda entre versões.

O Pi Coding Agent é um de 13 agentes de programação de linha de comandos que o Happier corre, e todos partilham uma lista de sessões, uma caixa de entrada de permissões, um conjunto de atalhos de teclado e uma configuração MCP.

You define an MCP server once, and because Pi Coding Agent does not consume MCP directly, Happier hands the same tool surface to it through the happier tools shell bridge instead — the same tools, delivered as commands it can run. The app previews the effective tool surface before a session starts, so which one you got is visible rather than inferred.

Isso conta sobretudo nos dias em que está a correr mais do que um: sessões de fornecedores diferentes lado a lado, e um toque numa notificação a abrir a sessão que levantou o pedido em vez da porta de entrada da aplicação. A lista completa está aqui.

Escrever happier pi num terminal inicia a sessão mesmo onde está, e a mesma sessão está na aplicação ao mesmo tempo. O que lê nessa shell é a apresentação que o próprio Happier faz da sessão — a transcrição, os pedidos de permissão, a saída das ferramentas — e não a interface do Pi Coding Agent. Ninguém tem de abdicar do terminal para ter um cliente de telemóvel.

Não há entrega para a TUI do próprio Pi Coding Agent. Isso existe para Claude Code, Codex e OpenCode; com Pi Coding Agent a sessão continua sendo do Happier nas duas pontas. happier attach <session-id> lista as sessões daquele computador e marca as que não consegue reconectar, em vez de falhar depois que você escolhe uma.

O guia de attach lista os casos em vez de prometer todos eles.

Um comando no computador que guarda o seu código, e depois happier pi no repositório em que quer trabalhar.

Os passo a passo estão nos guias. Tudo isto tem licença MIT, e o relay é um que pode correr você mesmo.