Tutorial 3: Trabalhando no seu telefone

Meta: seu iPhone recebe um empurrão quando Claude precisa de entrada; toque, anexe, responda.

O layout estreito do ccmux se adapta a um terminal da largura de um telefone – o TUI completo se reduz a uma visualização de coluna única projetada para telas pequenas.

ccmux — telefone

Configuração (única)

ccmux moshi-setup

Isso instala moshi-hooke, em seguida, executa moshi-hook host setup. Um código QR aparece no seu terminal. Abra o Aplicativo iOS Moshi, toque em Adicionar Host → Digitalizar QR, aponte seu telefone para o terminal. Feito.

O assistente também conecta as entradas de gancho do Claude Code para que as notificações sejam disparadas automaticamente.

Como funciona

Após o emparelhamento:

• O aplicativo Moshi lista todas as sessões tmux em seu Mac
• Quando Claude faz uma pausa (needs_input), seu telefone vibra com um push categorizado: approval_required ou task_complete
• Toque na notificação → seletor Moshi → anexar → responder → deslizar para longe

BEL substituto (não Moshi)

Um cliente de terminal pode suportar notificações locais para campainhas de terminal. A disponibilidade depende do cliente, de suas configurações e se a conexão permanece ativa. Isso é separado das notificações push nativas do Moshi.

Suprimir notificações duplicadas

Por padrão, a campainha do laptop toca mesmo quando o Moshi está emparelhado (complementar, não duplicado). Para silenciar a campainha quando Moshi estiver reportando:

# ~/.config/ccmux/config.toml
[notifications]
moshi_suppresses_bell = true

Configuração sem cabeça/com script

ccmux moshi-setup --token <token>

Ignora o fluxo QR — útil para máquinas remotas sem display.

Crie seu próprio cliente móvel

ccmuxd expõe um HTTP API - lista sessões, anexa a um terminal ativo (um PTY com ponte WebSocket), envia chaves, transmite eventos, lê notas e uso, além de um fluxo de emparelhamento + push (APNs/FCM). O Moshi app é o caminho móvel hoje; o mesmo API está aberto para integração de qualquer cliente. Veja o Referência HTTP API.

Detectou um erro ou algo desatualizado? Edite esta página em GitHub.