O Codex no seu telemóvel, a partir de uma app open-source

O Codex é o agente que o Happier lança em modo App Server por predefinição, e a consequência útil disso é uma recusa: se esse modo não estiver disponível para uma sessão nova, o arranque falha em vez de baixar em silêncio para algo mais fraco, por isso ACP ou MCP são escolhas que faz de propósito e não recursos alternativos que lhe acontecem por trás de uma sessão que passa depois a comportar-se de forma diferente da anterior.

O que está em jogo nessa escolha está escrito, não é uma questão de intuição. No runtime predefinido, uma conversa do Codex pode receber um fork, ser revertida para um ponto anterior e ser questionada sobre se um limite de utilização já foi levantado; escolha antes o runtime MCP ou ACP e a versão publicada deixa cair as três coisas, que é precisamente a razão por que uma degradação silenciosa seria uma gentileza mal dirigida. O Codex mantém também uma TUI do fornecedor que lhe pode ser devolvida — happier attach dá-lhe a verdadeira interface do Codex na sessão que já está a correr e, enquanto esse terminal a tiver, tudo o que enviar a partir da app fica à espera na fila em vez de aparecer por baixo do seu cursor.

É também um dos dois agentes cuja conta pode mudar a meio da sessão. Ligue uma vez uma subscrição do Codex ou uma chave da OpenAI e uma sessão que bata num limite numa delas pode ser transportada para outro perfil do mesmo grupo em vez de ser abandonada — no máximo uma vez por turno e três vezes por hora de sessão, por isso é uma recuperação e não uma rotação. O início de sessão em si continua a ser o do fornecedor: a página do fornecedor executa codex login no computador que escolheu, e a credencial que ela escreve fica aí.

A Codex CLI é o agente de programação em terminal da OpenAI, distribuído como binário de release a partir do repositório openai/codex. happier codex arranca esse binário no repositório para onde o apontar — os mesmos pedidos de aprovação, a mesma diretoria de trabalho, a mesma conta que se o executasse você mesmo.

O que muda é de onde o pode ler. A transcrição, os diffs dos ficheiros e os pedidos de aprovação aparecem na app Happier num telemóvel, num separador do navegador ou na app de desktop, encriptados de ponta a ponta antes de saírem do seu computador.

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 Codex CLI 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 codex inicia lá o Codex CLI 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 OpenAI, nem cópia nenhuma do seu código em mais lado nenhum.

O Happier procura primeiro codex no seu PATH e executa a cópia que você instalou. Se não houver nenhuma, ele pode baixar o binário da release openai/codex em ~/.happier/tools/providers/codex/ e mantê-lo lá. A sua própria instalação sempre tem prioridade.

A página da própria OpenAI sobre o Codex CLI está em github.com/openai/codex. O Happier não a 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 — Codex CLI na documentação do Happier.

O Codex CLI é 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 or an OpenAI 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 Codex CLI é 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 Codex CLI receives it as native MCP inventory, next to whatever MCP servers it already had of its own.

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 codex 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 Codex CLI. Ninguém tem de abdicar do terminal para ter um cliente de telemóvel.

Quando você quiser a TUI do próprio Codex CLI, happier attach <session-id> no computador dono da sessão a entrega para você dentro do tmux, com o histórico já ali. No runtime padrão essa entrega é exclusiva: enquanto o terminal está com a sessão, uma mensagem enviada pelo app espera na fila em vez de ser digitada por baixo de você, e sai quando você devolve o controle.

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 codex 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.