A Gemini CLI em todos os dispositivos que usa

O Gemini é o agente com maior probabilidade de estar a correr dentro da fronteira de faturação de outra pessoa e não num início de sessão de consumidor — um projeto e uma localização do Google Cloud, lidos do ambiente da shell do processo que o Happier arranca. É essa a parte que esta página existe para dizer que não muda.

É também a única credencial da Google que o Happier guarda. Ligue um perfil Gemini uma vez e fica selecionável no início da sessão em qualquer um dos seus computadores; o código OAuth é trocado no servidor e volta como um pacote encriptado, por isso nenhum segredo OAuth da Google é distribuído dentro da app que instalou. Há duas entradas, consoante o que tiver na mão: colar o URL de redirecionamento, ou deixar as apps nativas abrirem um navegador dentro da app. No cliente web é o fluxo de colar. Quando preferir não ligar nada, o Happier lê antes o sinal local — as variáveis de ambiente do próprio Gemini, os seus ficheiros de configuração e um ficheiro suportado de credenciais application-default da Google — e a página do fornecedor inicia gemini auth por si no computador que escolheu.

Por baixo disso, o Gemini aceita servidores MCP de forma nativa, por isso um servidor que definiu uma vez no Happier chega como inventário e não como um comando de shell de que tem de ser informado. O que a versão publicada não oferece para este é uma lista das sessões do Gemini que já existem nesse computador, nem uma forma de mover o estado do fornecedor para um segundo computador; uma sessão que iniciou através do Happier é retomada, e uma que iniciou num terminal simples não é coisa que a página finja encontrar. As skills que guarda em .gemini/skills são recolhidas e viajam com a sessão.

A Gemini CLI é o agente de programação em terminal open-source da Google. happier gemini arranca-a no seu repositório com o ambiente que a sua shell já tem — o que, em muitas organizações, significa um projeto e uma localização do Google Cloud em vez de um início de sessão de consumidor.

É essa forma de implantação que costuma tornar esta página relevante. O agente corre dentro da sua própria fronteira de faturação e de dados, e o Happier acrescenta apenas o transporte: uma sessão encriptada que pode ler num telemóvel, num navegador ou num segundo 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 Gemini 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 gemini inicia lá o Gemini 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 Google, nem cópia nenhuma do seu código em mais lado nenhum.

O Happier procura primeiro gemini no seu PATH e executa a cópia que você instalou. Se não houver nenhuma, ele pode instalar @google/gemini-cli em ~/.happier/tools/providers/gemini/ — 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.

A página da própria Google sobre o Gemini CLI está em goo.gle/gemini-cli-auth-docs. 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 — Gemini CLI na documentação do Happier.

O Gemini 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 Gemini login.

Os serviços conectados são indexados pela credencial, não pelo agente, então o mesmo Gemini login 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 Gemini 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 Gemini 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 gemini 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 Gemini CLI. Ninguém tem de abdicar do terminal para ter um cliente de telemóvel.

Não há entrega para a TUI do próprio Gemini CLI. Isso existe para Claude Code, Codex e OpenCode; com Gemini CLI 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 gemini 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.