A Kimi CLI a partir do telemóvel, do navegador ou do desktop

O Kimi é aquele que o Happier não atualiza por si, e isso vale a pena saber no primeiro dia e não no dia em que sai uma versão nova. A Moonshot distribui-o com um script de instalação em vez de um pacote, por isso não há uma cópia gerida dentro de ~/.happier/ que o Happier possa subir de versão — a versão no seu PATH é a que instalou da última vez, e obter uma mais recente passa por voltar a correr o instalador da Moonshot você mesmo.

A segunda coisa particular deste é como uma sessão só de leitura se torna só de leitura. O Kimi não tem flag para isso, por isso o Happier escreve uma pequena definição de agente Kimi própria — uma que estende o agente predefinido do Kimi e lhe retira as ferramentas de shell, de escrita de ficheiros e de substituição de texto — e arranca a CLI com esse ficheiro. O arranque é kimi --work-dir apontado à diretoria que escolheu, depois acp, com --yolo acrescentado quando desligou as aprovações. Portanto, Só de leitura aqui é imposto pela própria lista de ferramentas do agente e não por algo fora dele a decidir o que vetar.

O início de sessão é um comando de barra: a página do fornecedor arranca kimi no computador que escolheu e envia-lhe /setup. Depois disso, o Happier não vai à procura de confirmação — alguns destes comandos de estado imprimem tokens num terminal, por isso a sonda fica desligada e a página mostra Desconhecido em vez de ler algo que não lhe diz respeito. Se a sessão der mesmo um erro de autenticação, é aí que fica a saber: um 401 à saída da CLI é convertido numa instrução simples para executar kimi login e tentar de novo, em vez de um stack trace num registo que não estava a ver.

A Kimi CLI é o agente de programação em terminal da Moonshot AI, que conduz modelos Kimi sobre o seu repositório. happier kimi executa o binário que já instalou, na diretoria para onde o apontar, com a sua própria conta Kimi.

A parte que o Happier acrescenta não tem glamour e é toda a razão por que as pessoas o instalam: a sessão não acaba quando sai da secretária. Leia-a num telemóvel, responda a um pedido de permissão, envie a instrução seguinte e deixe-a continuar a trabalhar no computador que tem o código.

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 Kimi 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 kimi inicia lá o Kimi 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 Moonshot AI, nem cópia nenhuma do seu código em mais lado nenhum.

O Happier procura kimi no seu PATH e corre a cópia que instalou. A Moonshot AI distribui-o com um script de instalação em vez de um pacote; o Happier pode mostrar-lhe esse comando, e não executa um script de instalação do fornecedor por iniciativa própria — as receitas de fornecedores são recusadas a menos que as permita explicitamente.

O guia de instalação e login da própria Moonshot AI está em kimi.moonshot.cn/docs/cli. 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 — Kimi CLI na documentação do Happier.

O Kimi 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 because Kimi CLI 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 kimi 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 Kimi 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 Kimi CLI. Isso existe para Claude Code, Codex e OpenCode; com Kimi 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 kimi 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.