Corra a Cursor Agent CLI a partir do seu telemóvel

O que há a saber sobre o Cursor antes de tudo o resto é que o binário não é o que instalou para o editor. O Happier procura cursor-agent, a CLI headless, e deliberadamente nunca cursor, que na maioria dos computadores abre uma janela do editor — sem utilidade num computador onde não está ninguém sentado. A própria documentação da CLI do Cursor escreve o comando como agent, por isso o Happier também aceita um binário com esse nome, mas só depois de lhe perguntar about --format json e receber de volta uma versão do Cursor: um agent perdido no seu PATH não passa a ser o seu agente de programação por acidente.

A Anysphere descreve a CLI como uma forma de “interagir com agentes de IA diretamente a partir do terminal para escrever, rever e modificar código”, e coloca ao mesmo nível uma interface interativa e a automação em modo print para scripts e pipelines de CI. É essa segunda metade a razão por que esta página existe — a coisa corre perfeitamente sem ninguém a olhar para ela, o que torna a pergunta de onde a lê numa pergunta real. O Happier também consegue responder se o Cursor tem sessão iniciada nesse computador, em vez de encolher os ombros: a mesma chamada about reporta a conta, e uma CURSOR_API_KEY no ambiente é respeitada se for assim que a máquina está configurada.

Dois comportamentos do Cursor exigiram trabalho próprio do lado do Happier. Gera imagens, e elas chegam à transcrição como media da sessão em vez de um caminho de ficheiro que tem de ir procurar. E faz perguntas estruturadas — com opções, seleção múltipla e uma caixa de texto livre — que a app desenha como uma pergunta e não como um muro de texto a que tem de responder em prosa; o seu passo de plano chega como um plano que aprova ou devolve. A escolha de modelo é lida da sua própria CLI, e um modelo que anuncia variantes chega como uma única entrada com um controlo de esforço de raciocínio e um interruptor de modo rápido. O retomar é o único sítio onde o Happier é deliberadamente pessimista: a versão publicada marca-o como experimental, verifica-o contra o binário que tem antes de o oferecer, e um retomar que falha falha, em vez de abrir em silêncio uma conversa nova com o título antigo.

O agente de linha de comandos do Cursor é um binário separado do editor: cursor-agent, que conduz um repositório a partir de um terminal e, por isso, corre perfeitamente numa máquina sem interface gráfica. happier cursor arranca-o com a sua própria conta Cursor.

Se a razão por que está aqui é “pago pelo Cursor e não estou à secretária”, a funcionalidade é toda essa. O agente corre onde está o seu repositório; você lê-o, aprova-o e orienta-o a partir do dispositivo que tiver na mão.

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

O Happier procura cursor-agent no seu PATH e corre a cópia que instalou. A Anysphere 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 Anysphere está em cursor.com/docs/cli/installation. 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.

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