Wendov1.0 · iOS e Android
Italiano

Avvisi e approvazioni

Wendo ti avvisa quando Claude Code chiede un permesso, fa una domanda o finisce, e ti lascia approvare o rifiutare dal telefono. Non ci sono server intermedi né account: uno script sul tuo computer scrive ogni evento in ~/.wendo/events.jsonl, e l’app lo legge via SSH con la tua chiave.

Dove si trova

  • Posta in arrivo: gli avvisi di tutti i tuoi host. Ogni riga si può approvare o rifiutare.
  • Impostazioni › Agenti › Hook: il comando di installazione e la configurazione manuale.
  • Impostazioni › Agenti › Notifiche: come ti avvisa l’app e il topic di ntfy.

Installazione

Sul tuo computer (macOS o Linux; su Windows, dentro WSL):

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

Scarica wendo-hook.sh e wendo-pair.sh in ~/.wendo, installa jq e qrencode con il gestore di pacchetti del sistema, aggiunge l’hook a ~/.claude/settings.json (salvando prima una copia come settings.json.bak-wendo) e mostra il QR code per l’abbinamento. Puoi rilanciarlo senza che nulla venga duplicato.

Opzioni, dopo sh -s --: --no-deps (non installa pacchetti), --no-claude (non tocca la configurazione di Claude) e --no-pair (non mostra il QR code). Per esempio:

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

Eventi che registra: PermissionRequest, Notification, Stop, UserPromptSubmit, SessionStart e SessionEnd.

Come funziona un’approvazione

Quando arriva un PermissionRequest, l’hook aspetta fino a 90 secondi che tu risponda dall’app. Se non rispondi, non fa nulla e Claude Code te lo chiede nel terminale come sempre. Puoi regolarlo con variabili d’ambiente nel comando dell’hook:

  • WENDO_APPROVAL_TIMEOUT: secondi di attesa. Il timeout dell’hook in settings.json (120) deve essere maggiore.
  • WENDO_BLOCKING=0: solo avvisi, senza aspettare una risposta.
  • WENDO_HOST: il nome del computer, se l’app lo conosce con un nome diverso da hostname -s.

Le domande (AskUserQuestion) e l’approvazione dei piani (ExitPlanMode) non bloccano: rispondi dalla Vista chat.

Notifiche ad app chiusa

Con l’app aperta, Wendo legge la posta in arrivo ogni pochi secondi. Con l’app chiusa usa ntfy:

  1. Metti NTFY_TOPIC=<un topic lungo e casuale> davanti al comando dell’hook.
  2. Iscriviti a quel topic nell’app ntfy.
  3. Inserisci lo stesso topic in Impostazioni › Agenti › Notifiche.

Il topic fa da password, quindi sceglilo difficile da indovinare. Con NTFY_URL puoi usare un tuo server ntfy. Su Android c’è anche un controllo in background almeno ogni 15 minuti.

Requisiti e limiti

  • Serve jq. curl serve solo per ntfy.
  • Per ora solo Claude Code: l’hook non è registrato per gli altri agenti.
  • Esegui Claude dentro tmux, zellij o herdr, così toccando un avviso arrivi al suo pane nell’app.
  • Il piano gratuito include 5 approvazioni di prova dalla posta in arrivo. Con Pro non ci sono limiti.