Wendov1.0 · iOS e Android
Português (Brasil)

Avisos e aprovações

O Wendo avisa quando o Claude Code pede permissão, faz uma pergunta ou termina, e deixa você aprovar ou negar pelo celular. Não há servidor intermediário nem conta: um script no seu computador grava cada evento em ~/.wendo/events.jsonl e o app o lê por SSH com a sua chave.

Onde fica

  • Caixa de entrada: os avisos de todos os seus hosts. Cada linha pode ser aprovada ou negada.
  • Ajustes › Agentes › Hooks: o comando de instalação e a configuração manual.
  • Ajustes › Agentes › Notificações: como o app avisa e o tópico do ntfy.

Instalar

No computador (macOS ou Linux; no Windows, dentro do WSL):

curl -fsSL https://wendo.lirafy.dev/install.sh | sh

Ele baixa wendo-hook.sh e wendo-pair.sh para ~/.wendo, instala jq e qrencode com o gerenciador de pacotes do sistema, adiciona o hook a ~/.claude/settings.json (antes salvando uma cópia em settings.json.bak-wendo) e mostra o QR code para o pareamento. Você pode repetir sem que nada seja duplicado.

Opções, depois de sh -s --: --no-deps (não instala pacotes), --no-claude (não mexe na configuração do Claude) e --no-pair (não mostra o QR code). Por exemplo:

curl -fsSL https://wendo.lirafy.dev/install.sh | sh -s -- --no-deps

Eventos que ele registra: PermissionRequest, Notification, Stop, UserPromptSubmit, SessionStart e SessionEnd.

Como funciona uma aprovação

Quando chega um PermissionRequest, o hook espera até 90 segundos que você responda pelo app. Se você não responder, ele não faz nada e o Claude Code pergunta no terminal, como sempre. Dá para ajustar com variáveis de ambiente no comando do hook:

  • WENDO_APPROVAL_TIMEOUT: segundos de espera. O timeout do hook em settings.json (120) precisa ser maior.
  • WENDO_BLOCKING=0: só avisa, sem esperar resposta.
  • WENDO_HOST: o nome do computador, se no app ele tem um nome diferente de hostname -s.

As perguntas (AskUserQuestion) e a aprovação de planos (ExitPlanMode) não bloqueiam: elas são respondidas pela Visualização de chat.

Avisos com o app fechado

Com o app aberto, o Wendo lê a caixa de entrada a cada poucos segundos. Com o app fechado, usa o ntfy:

  1. Coloque NTFY_TOPIC=<a long, random topic> antes do comando do hook.
  2. Assine esse tópico no app do ntfy.
  3. Digite o mesmo tópico em Ajustes › Agentes › Notificações.

O tópico funciona como senha: que não seja fácil de adivinhar. Com NTFY_URL você pode usar o seu próprio servidor ntfy. No Android, há também uma verificação em segundo plano pelo menos a cada 15 minutos.

Requisitos e limites

  • Precisa de jq. O curl só é necessário para o ntfy.
  • Por enquanto só o Claude Code: o hook não é registrado em outros agentes.
  • Rode o Claude dentro do tmux, zellij ou herdr para que, ao tocar em um aviso, o app leve você ao painel dele.
  • O plano grátis inclui 5 aprovações de teste pela caixa de entrada. Com o Pro não há limite.