moshterm

~ moshterm-hook

O Companion

moshterm-hook é um programa pequeno que roda no computador usado pelos seus agentes. É o que transforma um terminal em algo que sabe quando um agente está esperando.

Baixe o app para celular

O moshterm para Android já está no Google Play, e o app para iPhone e iPad chega em breve. O terminal e os recursos do Companion são grátis; o moshterm Pro adiciona prévias ao vivo.

App Store em breve Disponível no Google Play

O que ele adiciona

  • Aprovações: o pedido de permissão de um agente chega no seu celular, e a sua resposta volta para ele.
  • Inbox e notificações: qual sessão precisa de você, quais estão trabalhando e quais terminaram.
  • Vista de chat: a transcrição do agente, lida no seu computador e exibida como conversa.
  • Jump To e a lista de sessões do tmux, Zellij e Herdr no seletor.
  • Diffs e navegação de arquivos da pasta em que o terminal está.

Sem ele, o moshterm continua sendo um terminal completo de Mosh, Eternal Terminal e SSH.

O jeito fácil

Conecte-se ao computador pelo app. Se o Companion ainda não estiver instalado, o moshterm oferece instalá-lo por essa mesma conexão; confirme e ele cuida do resto. Depois, o app mantém um Companion antigo atualizado do mesmo jeito quando você conecta.

Na mão

No macOS, Linux ou WSL:

# instala em ~/.local/bin e inicia o serviço em segundo planocurl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh

O instalador confere o download com as somas publicadas quando o sistema tem uma ferramenta SHA-256. Depois adicione os hooks para os seus agentes:

# grava apenas as entradas do moshterm; as suas ficam intactasmoshterm-hook install

Agentes com hooks gerenciados: Claude Code, Codex, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi e OMP. moshterm-hook uninstall remove só o que install gravou.

Pareamento

Não há nada para copiar. Na primeira vez que o celular conecta por SSH, ele pede o token ao Companion por essa mesma sessão e, a partir daí, conversa com ele pela conexão SSH. Para adicionar um computador por QR code em vez de digitar o endereço, rode moshterm-hook pair --qr e escaneie pelo app.

Onde ele fica

  • Roda com o seu usuário e escuta apenas em 127.0.0.1. Em um computador com várias contas, o celular confirma que está falando com o seu Companion, e não com o de outra pessoa, antes de enviar qualquer coisa.
  • O estado dele fica em ~/.moshterm/, legível apenas por você.
  • É um único binário estático, compilado para macOS e Linux em ARM e x86.

Mosh e tmux no host

Para sessões que sobrevivem à troca de rede, o computador precisa do mosh-server; para sessões que continuam vivas após desconectar, de um multiplexador. Eternal Terminal é opcional.

# macOSbrew install mosh tmux
# Debian, Ubuntu, WSLsudo apt install mosh tmux

Quando algo não vai bem

moshterm-hook doctor imprime o que o Companion em execução está vendo: endereço, ferramentas encontradas, estado dos hooks de cada agente e se está pareado. Funciona por SSH, então você pode rodar direto do celular.

Ainda travado? Em Suporte (em inglês) está o endereço para escrever.