Aplicació de codi obert per al Pi Coding Agent

Pi no distribueix cap model, cosa que resulta ser el fet interessant d’executar-lo aquí: cada credencial d’agent que Happier guarda és una que Pi acceptarà. Els perfils de subscripció de Claude, les claus d’Anthropic, els inicis de sessió de Codex i les claus d’OpenAI funcionen tots, de manera que els comptes que vas reunir perquè fas servir Claude Code també poden conduir això — triat en començar la sessió i no decidit pel que aquell ordinador tingués iniciat per última vegada.

El mecanisme mereix una frase perquè explica què es mou i què no. Abans d’engegar, Happier escriu el perfil que has triat al fitxer de credencials aïllat propi de Pi, amb la forma que Pi espera: un inici de sessió de subscripció esdevé una credencial d’OAuth; un token de configuració o una clau d’API esdevé una clau. Després Pi llegeix el seu propi fitxer i parla directament amb el proveïdor, sense que cap petició teva passi per res nostre. Si diversos dels teus perfils hi encaixen, l’aplicació et pregunta quin en comptes de triar per tu.

Per a aquest agent no hi ha cap botó d’inici de sessió, i això és cosa de Pi i no una omissió: no exposa cap inici de sessió interactiu que Happier pugui conduir, de manera que la pàgina del proveïdor informa de les credencials basades en l’entorn que aquell ordinador ja porta i s’atura aquí. Dirigir sí que funciona — un missatge enviat a un torn que ja s’està executant l’agafa l’agent en comptes d’esperar-se al darrere —, mentre que escriure en un terminal del proveïdor no és res que aquest agent ofereixi. Pi és un proveïdor experimental a Happier, que és l’estat amb què cal llegir-lo.

Pi és un agent de programació al terminal de tipus «porta la teva clau»: no distribueix cap model, condueix el proveïdor del qual tinguis credencials. happier pi l’executa al teu repositori amb l’entorn que el teu shell ja té.

Això encaixa amb la manera de funcionar de Happier, perquè Happier tampoc no guarda aquestes claus. El procés de l’agent les llegeix al teu ordinador, parla directament amb el proveïdor, i l’única cosa que travessa la xarxa és una transcripció xifrada que va als teus propis dispositius.

Així, la forma d’una sessió de Pi és: les teves claus, el teu ordinador, el teu repositori i un telèfon a la butxaca que pot llegir la conversa i respondre-la. Res d’aquesta llista no ens el llogues, i el relay del mig és un que pots executar tu mateix si prefereixes no fer servir el nostre.

Les aplicacions d'iOS i Android, l'aplicació d'escriptori per a macOS, Windows i Linux, i app.happier.dev són tots clients del procés de Pi Coding Agent que s'executa al teu ordinador — no rèpliques de només lectura. Respon una sol·licitud de permís, envia la instrucció següent, navega pel repositori, llegeix el diff. La transcripció es xifra d'extrem a extrem abans de sortir del teu ordinador, així que el servidor que la transporta guarda text xifrat.

Happier s'instal·la a l'ordinador que ja conté el teu repositori, i happier pi hi inicia Pi Coding Agent com un subprocés corrent, al directori que li indiquis, amb la sessió iniciada tal com la vas iniciar tu. No hi ha cap passarel·la entre l'agent i Pi, ni cap còpia del teu codi font en cap altre lloc.

Happier busca primer pi al teu PATH i executa la còpia que has instal·lat. Si no n’hi ha cap, pot instal·lar @earendil-works/pi-coding-agent a ~/.happier/tools/providers/pi/ — un directori propi, no el teu prefix global d’npm. Una còpia que gestiones tu no se substitueix ni s’actualitza mai a la teva esquena.

La guia d’instal·lació i inici de sessió de Pi és a github.com/badlogic/pi-mono. Happier no la replica, perquè una còpia de les instruccions d’instal·lació d’algú altre és una còpia que es queda desactualitzada.

Referència de configuració de la part de Happier — Pi Coding Agent a la documentació de Happier.

Pi Coding Agent és un dels agents que Happier pot apuntar a una credencial que has connectat una vegada, en lloc del compte amb què aquell ordinador ha iniciat la sessió. Accepta a Codex subscription, an OpenAI API key, a Claude subscription or an Anthropic API key.

Els serveis connectats s’indexen per credencial, no per agent, de manera que el mateix Codex subscription es pot seleccionar per a qualsevol agent que l’accepti, a tots els ordinadors que has connectat — i això és també el que fa útil un pool dels teus propis comptes en més d’un. La credencial es xifra i es desxifra als teus propis dispositius; la pàgina de documentació recull les regles per perfil, perquè quins tipus de perfil accepta cada agent és exactament la mena de detall que canvia entre versions.

Pi Coding Agent és un dels 13 agents de línia d'ordres que Happier executa, i comparteixen una sola llista de sessions, una safata de permisos, un conjunt de dreceres de teclat i una configuració d'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.

Això importa sobretot els dies que en fas anar més d'un: sessions de proveïdors diferents de costat, i una pulsació a la notificació que obre la sessió que ha fet la sol·licitud en lloc de la portada de l'aplicació. La llista completa és aquí.

Escriure happier pi en un terminal inicia la sessió just on ets, i la mateixa sessió és a l'aplicació al mateix temps. El que llegeixes en aquell intèrpret d'ordres és la visualització que Happier fa de la sessió — la transcripció, els avisos de permís, la sortida de les eines — i no la interfície de Pi Coding Agent. Ningú no ha de renunciar al terminal per tenir un client al telèfon.

No hi ha lliurament a la TUI pròpia de Pi Coding Agent. Això existeix per a Claude Code, Codex i OpenCode; amb Pi Coding Agent la sessió continua sent la de Happier als dos extrems. happier attach <session-id> llista les sessions d’aquell ordinador i marca les que no pot tornar a enganxar, en comptes de fallar després que n’hagis triat una.

La guia d'attach enumera els casos en lloc de prometre'ls tots.

Una ordre a l'ordinador que conté el teu codi, i després happier pi al repositori on vulguis treballar.

Els tutorials són a les guies. Tot plegat té llicència MIT, i el relay és un que pots executar tu mateix.