Wendov1.0 · iOS & Android
한국어

알림과 승인

Wendo는 Claude Code가 권한을 요청하거나, 질문하거나, 작업을 끝내면 알려 주고, 폰에서 승인하거나 거부할 수 있게 해 줍니다. 중간 서버도 계정도 없습니다. 컴퓨터의 스크립트가 각 이벤트를 ~/.wendo/events.jsonl에 기록하고, 앱은 당신의 키로 SSH를 통해 그 파일을 읽습니다.

어디에 있나요

  • 받은 편지함: 모든 호스트의 알림이 모입니다. 각 행에서 승인하거나 거부할 수 있습니다.
  • 설정 › 에이전트 › 훅: 설치 명령과 수동 설정.
  • 설정 › 에이전트 › 알림: 앱이 알리는 방식과 ntfy 토픽.

설치

컴퓨터에서(macOS 또는 Linux, Windows에서는 WSL 안에서) 실행합니다.

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

wendo-hook.sh와 wendo-pair.sh를 ~/.wendo에 내려받고, 시스템 패키지 관리자로 jq와 qrencode를 설치하고, ~/.claude/settings.json에 훅을 추가하며(먼저 settings.json.bak-wendo로 사본을 저장합니다), 페어링용 QR 코드를 보여 줍니다. 다시 실행해도 중복되는 것은 없습니다.

옵션은 sh -s -- 뒤에 붙입니다. --no-deps(패키지를 설치하지 않음), --no-claude(Claude 설정을 건드리지 않음), --no-pair(QR 코드를 보여 주지 않음). 예를 들면 다음과 같습니다.

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

기록하는 이벤트는 PermissionRequest, Notification, Stop, UserPromptSubmit, SessionStart, SessionEnd입니다.

승인이 동작하는 방식

PermissionRequest가 도착하면 훅은 앱에서 답할 때까지 최대 90초를 기다립니다. 답하지 않으면 아무것도 하지 않고, Claude Code가 평소처럼 터미널에서 묻습니다. 훅 명령에 환경 변수를 지정해 조절할 수 있습니다.

  • WENDO_APPROVAL_TIMEOUT: 기다릴 초 단위 시간. settings.json에 있는 훅의 timeout(120)이 이보다 커야 합니다.
  • WENDO_BLOCKING=0: 알림만 보내고 답을 기다리지 않습니다.
  • WENDO_HOST: 앱에 hostname -s와 다른 이름으로 등록되어 있을 때 쓰는 컴퓨터 이름.

질문(AskUserQuestion)과 계획 승인(ExitPlanMode)은 대기하지 않습니다. 채팅 보기에서 답합니다.

앱을 닫았을 때의 알림

앱이 열려 있으면 Wendo는 몇 초마다 받은 편지함을 읽습니다. 앱이 닫혀 있으면 ntfy를 씁니다.

  1. 훅 명령 앞에 NTFY_TOPIC=<길고 무작위인 토픽>을 붙입니다.
  2. ntfy 앱에서 그 토픽을 구독합니다.
  3. 설정 › 에이전트 › 알림에 같은 토픽을 입력합니다.

토픽은 비밀번호 역할을 하므로 추측하기 어렵게 정하세요. NTFY_URL로 직접 운영하는 ntfy 서버를 쓸 수 있습니다. Android에서는 최소 15분마다 백그라운드 확인도 합니다.

필요한 것과 제한 사항

  • jq가 필요합니다. curl은 ntfy에만 필요합니다.
  • 지금은 Claude Code만 지원합니다. 다른 에이전트에는 훅이 등록되지 않습니다.
  • 알림을 탭했을 때 앱에서 해당 패널로 이동하려면 Claude를 tmux, zellij, herdr 안에서 실행하세요.
  • 무료 플랜에는 받은 편지함에서 쓸 수 있는 체험 승인 5회가 포함됩니다. Pro에는 제한이 없습니다.