Remote Harness GitHub ↗
Criptografado de ponta a ponta · tmux · código aberto

Acompanhe e comande seus agentes de código pelo celular.

O Claude Code, o Codex, o Gemini CLI, o Kimi CLI ou o Qwen Code roda no tmux da sua própria máquina. O Remote Harness transmite a conversa para o seu celular de qualquer lugar, com criptografia de ponta a ponta: você lê o que o agente fez, responde aos pedidos de permissão, manda o próximo prompt e abre novas sessões.

macOS · Linux · Windows (WSL2)iOS · AndroidMIT, sem conta, sem VPN
Funciona com Claude Code Codex CLI Gemini CLI Kimi Qwen Code Modelos do OpenRouter via perfis
Como funciona

Seu celular, sua máquina. Nada no meio consegue ler.

As sessões rodam dentro do tmux. O agente conta o que acontece pelos seus hooks nativos, um daemon pequeno na máquina faz a ponte com o celular, e a criptografia de ponta a ponta mantém tudo privado.

Seu celular

App nativo para iOS e Android. Lê a conversa, responde permissões, manda prompts, teclas, fotos e voz. Push e status ao vivo, sem conteúdo dentro.

Sua máquina

O daemon remote-harness: acompanha os transcripts, controla o tmux, recebe os hooks do agente em 127.0.0.1. Uma linha para instalar, um item de login ou unidade systemd para manter rodando.

Seus agentes, no tmux

Uma janela por sessão, um alias por perfil, para Claude Code, Codex, Gemini CLI, Kimi CLI ou Qwen Code.

pessoal → ~/.claude
veja mais
trabalho → ~/.claude-workcodex → ~/.codexgem → ~/.geminikm → ~/.kimiqw → ~/.qwenopenrouter → ~/.claude-openrouter
  1. Instale na máquina

    Um comando. Ele confere tmux, git, ripgrep e Node, encontra seus perfis e instala os atalhos.

  2. Escaneie o QR code

    A instalação mostra no fim (ou remote-harness pair). Em casa ou fora, o celular acha a máquina, pronto.

  3. Rode o seu alias

    trabalho abre o Claude Code no tmux com aquele perfil. A sessão aparece no celular, totalmente controlável.

Recursos

Tudo o que o terminal mostra, e as partes que o terminal não consegue.

Uma lista, todos os perfis

Sessões de todos os seus perfis, ordenadas pelo que se mexeu por último, com uma faixa “esperando você” no topo.

Conversa ao vivo

Markdown, raciocínio, chamadas de ferramenta, diffs e resultados, transmitidos na hora e paginados até o começo.

Permissões no bolso

Permitir, negar ou permitir sempre. O “sempre” vira uma regra escrita pelo próprio agente, desfazível pela CLI.

Fila ou enviar agora

Enfileire os próximos pedidos enquanto o agente trabalha; eles entram em ordem quando o turno termina. Segure para enviar na hora.

Terminal bruto

O próprio painel do tmux, para menus e tudo o que a visão estruturada não cobre, com uma barra de teclas para Esc, Ctrl+C, setas e Tab.

Abrir, retomar, encerrar

Novas sessões em qualquer pasta, opcionalmente num worktree git próprio. Retome as somente leitura. Encerre com limpeza do worktree que nunca descarta trabalho em silêncio.

Status ao vivo

Tela de bloqueio e Dynamic Island no iOS, uma notificação silenciosa no Android: estado, tipo de passo e tempo decorrido, nunca o texto.

Subagentes, voz, fotos

Acompanhe subagentes e tarefas em segundo plano, dite prompts no aparelho, anexe fotos. Autocompletar para @arquivos e /comandos.

Privacidade e segurança

O daemon é um shell remoto, então vem trancado por padrão.

O relay não consegue lerEm casa o app fala direto com o daemon; fora, por um relay de conexão. Os dois caminhos têm criptografia de ponta a ponta com Noise e chaves por aparelho, então o relay só repassa bytes que não consegue ler, e não guarda registros.
Chaves por aparelhoCada celular pareia com um código de uso único que expira em 5 minutos e ganha chaves próprias, guardadas no Keychain (macOS), no Secret Service (Linux) ou no armazenamento seguro do celular. Revogue qualquer um quando quiser.
Push sem conteúdoAs notificações levam um título, um perfil e um id de sessão. O status ao vivo acrescenta o nome e a pasta da sessão, nada da conversa.
Sem bypassO app nunca oferece o modo “bypass permissions” do agente. Edições nos seus dotfiles são mescladas, com backup e totalmente reversíveis.
Só se você quiserNada é enviado a lugar nenhum sem a sua escolha: push pelo seu próprio projeto Firebase ou pelo relay sem conteúdo, relatórios de erro e dados de desempenho, sempre sem conteúdo das sessões.
Código abertoLicença MIT, construído às claras com OpenSpec. Leia o SECURITY.md para relatar um problema.
Instalar

Uma linha na máquina, um escaneio no celular.

curl -fsSL https://remoteharness.app/install | bash

Confere o sistema, instala o que falta (Homebrew, apt, dnf, pacman ou zypper), compila o daemon e abre a instalação guiada.

  • Node 24+ (incluído se faltar)
  • tmux
  • git
  • ripgrep
  • claude, codex, gemini, kimi ou qwen no PATH

Baixar o app

iPhone e iPadTestFlight (beta) · iOS 17+ AndroidGoogle Play (teste) · Android 10+

Nada mais para instalar no celular. Instalou o app primeiro? A tela de pareamento guia a instalação na máquina.

Docs e FAQ

As primeiras perguntas

O guia completo está na documentação: primeiros passos, uso do app, a CLI do daemon, segurança, solução de problemas.

Funciona fora de casa?

Sim: direto em casa e, fora, pelo relay de conexão com criptografia de ponta a ponta, sem abrir portas nem VPN. A máquina precisa estar acordada; a página Solução de problemas das docs cobre as opções de suspensão e bloqueio.

Quais agentes são suportados?

Claude Code, Codex CLI, Gemini CLI, Kimi CLI e Qwen Code, com todos os perfis (CLAUDE_CONFIG_DIR, CODEX_HOME, ~/.gemini, KIMI_SHARE_DIR, QWEN_HOME) numa lista só, inclusive perfis do Claude Code roteados pelo OpenRouter.

Ele roda meu agente sem supervisão?

Só até onde os modos de permissão do próprio agente permitem. O app oferece padrão, aceitar edições, plano e auto; nunca oferece bypass. Toda permissão continua passando por você, no celular ou na máquina.

E as sessões abertas fora do tmux?

Continuam aparecendo, somente leitura. Retome uma pelo celular e ela reabre dentro do tmux, totalmente controlável.

Existe algum componente na nuvem?

Só relays que não conseguem ler nada. Fora de casa o relay de conexão repassa o tráfego criptografado de ponta a ponta (ou rode o seu), e o push opcional passa pelo FCM (seu projeto Firebase ou o relay de push sem conteúdo). Nada guarda as suas sessões.

O daemon precisa de um Mac?

Não: macOS, Linux (systemd) e Windows via WSL2 são suportados. O app roda em iOS e Android.