Docs · Tópico
Configurar um host
Configurar um host conecta os hooks de ciclo de vida dos seus agentes de programação ao Moshpit para que o celular veja o estado de cada agente e receba pushes criptografados quando um agente precisar de você ou concluir um turno.
Executar a configuração do host
Section titled “Executar a configuração do host”O Moshpit nunca altera nada no host em silêncio. Ele pede permissão antes da primeira instalação quando você conecta, e você pode conferir, testar, reparar ou remover a configuração quando quiser:
- Conecte-se ao host no Moshpit.
- Abra Ajustes › Configurar este host e toque no host conectado.
- Em Status do agente, escolha um agente e toque em Instalar (ou Atualizar / Reinstalar). Toque na linha de teste logo abaixo dentro de um painel tmux aberto para confirmar que o script funciona.
- Em Notificações push, toque em Parear (ou Parear de novo) e depois toque em Enviar uma notificação de teste mantendo o Moshpit aberto na tela para confirmar a entrega completa.
Os pushes exigem openssl e curl no host. Instalar jq é opcional e permite que as notificações de conclusão incluam o prompt que o agente respondeu.
O que é gravado no host
Section titled “O que é gravado no host”Todos os arquivos do Moshpit ficam em ~/.moshpit, e apenas os agentes encontrados naquele host recebem entradas de hooks — a menos que você confirme explicitamente instalar para outro agente:
| Caminho | Finalidade |
|---|---|
~/.moshpit/moshpit-stamp.sh |
Chamado pelos hooks do agente; grava opções @moshpit_* no painel do tmux e dispara pushes para «precisa de você» e «concluído». |
~/.moshpit/moshpit-push.sh |
Criptografa o status no host e envia o texto cifrado ao relay de push. |
~/.moshpit/manifest.json |
Resumos SHA-256 dos arquivos instalados para o Moshpit detectar quando os scripts estão desatualizados. |
~/.moshpit/push.d/<connection-id>.conf |
Segredo de pareamento de 256 bits e token de envio deste celular, gravados com permissão 0600. |
<config>.moshpit.orig |
Backup único salvo antes de o Moshpit editar pela primeira vez o arquivo de configuração de um agente. |
Conforme os agentes presentes no host, o Moshpit mescla entradas de hooks em ~/.claude/settings.json, ~/.codex/config.toml, ~/.gemini/settings.json, ~/.qwen/settings.json, ~/.qoder/settings.json, ~/.factory/settings.json (ou ~/.factory/hooks.json) e ~/.codebuddy/settings.json. As configurações existentes nesses arquivos são preservadas.
Confiar nos hooks no Codex
Section titled “Confiar nos hooks no Codex”O Codex não executa hooks recém-adicionados até você aprová-los no host:
- Inicie o
codexem um shell no seu host. - Rode
/hooks. - Marque as quatro entradas do Moshpit como confiáveis.
Enquanto esse passo não for concluído, o Codex não informa estado no tmux nem envia pushes.
Desfazer ou remover
Section titled “Desfazer ou remover”Abra Ajustes › Configurar este host enquanto estiver conectado ao host:
- Apenas um agente: selecione o agente em Status do agente e toque em Remover.
- Pushes neste celular: toque em Desparear em Notificações push para apagar o arquivo de pareamento deste aparelho e interromper pushes vindos daquele host.
- Tudo: toque em Remover Moshpit deste host e confirme. O Moshpit retira suas entradas de hooks de todos os arquivos de configuração dos agentes (deixando o resto intacto), remove o pareamento deste celular e apaga
~/.moshpitse nenhum outro aparelho ainda estiver pareado com o host.