A Kilo CLI no seu telemóvel, portátil e navegador

O Kilo é um fornecedor experimental no Happier, e esta página di-lo logo no início e não ao fundo. O que isso significa na prática é estreito: a instalação é um pacote npm vulgar, a sessão é um subprocesso vulgar, e as partes por que as pessoas instalam o Happier — transcrição, diffs, aprovações em todos os dispositivos — são as vulgares. Significa, sim, que o fornecedor fica atrás da distribuição experimental nas definições de fornecedores da app, por isso é um interruptor que liga e não uma linha que já lá está.

A proposta do próprio Kilo é orquestração — “planear, depurar e programar depressa com navegação centrada no teclado na linha de comandos” —, com os modos Architect, Ask, Debug e Orchestrator e um gateway próprio para um grande catálogo de modelos. O Happier não põe um modelo à frente de nada disso; o que faz é falar o mesmo dialeto de permissões que o Kilo já entende. As aprovações chegam como um objeto OPENCODE_PERMISSION no ambiente do processo, o mesmo que a família OpenCode lê, por isso uma escolha de Só de leitura ou de Safe YOLO feita num telemóvel é imposta pela própria política da CLI e não por algo a adivinhar em nome dela.

Vale a pena conhecer um detalhe das aprovações antes que o apanhe desprevenido. Quando permite uma chamada de ferramenta do Kilo, o Happier escolhe a opção “permitir nesta sessão” em vez de “permitir uma vez”, porque se observou que a escolha de uma só vez deixava a chamada de ferramenta pendurada. A outra coisa a esperar é o primeiro arranque: o Kilo pode instalar plugins e ir buscar metadados de modelos na primeira vez que sobe pelo protocolo, por isso são dados noventa segundos ao arranque antes de ser dado como falhado e, se foi o passo dos plugins que falhou, é-lhe dito para executar kilo uma vez num terminal em vez de lhe ser mostrado o stderr. O início de sessão também é um comando de barra — a página do fornecedor abre o Kilo e envia /connect.

A Kilo CLI é um agente de programação em terminal instalado como pacote npm. happier kilo executa-o no seu repositório com a sua própria conta Kilo, como um subprocesso simples no seu computador.

A partir daí comporta-se como tudo o resto no Happier: a transcrição, os diffs e os pedidos de aprovação estão em todos os dispositivos onde tem sessão iniciada, e o código nunca sai do computador onde o agente está a correr.

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

O Happier procura primeiro kilo no seu PATH e executa a cópia que você instalou. Se não houver nenhuma, ele pode instalar @kilocode/cli em ~/.happier/tools/providers/kilo/ — 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 Kilo sobre o Kilo CLI está em kilo.ai/docs/cli. 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 — Kilo CLI na documentação do Happier.

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