Pular para o conteúdo
moshpit
PT-BR

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.

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:

  1. Conecte-se ao host no Moshpit.
  2. Abra Ajustes › Configurar este host e toque no host conectado.
  3. 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.
  4. 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.

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.

O Codex não executa hooks recém-adicionados até você aprová-los no host:

  1. Inicie o codex em um shell no seu host.
  2. Rode /hooks.
  3. 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.

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 ~/.moshpit se nenhum outro aparelho ainda estiver pareado com o host.