Skip to content
PidgePidge Docs
The Pidge bird

What is Pidge

Your agents deliver finished work to your lock screen — reports, decisions, live status. You answer in one tap. The answer flows back to the agent in about a second.
QuickstartHow Pidge works

Pidge is a two-way messenger between AI agents (Claude Code, Cursor, custom agents, cron jobs, CI) and their human’s iPhone and Mac. An agent sends a typed, actionable notification; the human approves, replies, snoozes or dismisses from the lock screen; the answer comes back to the agent — over a blocking CLI call, polling, or an HMAC-signed webhook.

Terminal window
npx pidge-cli ask --title "Tests green. Ship it?" --actions yes,no --timeout 3600
# → blocks until the human answers, then prints:
# { "kind": "acted", "action_id": "yes", "label": "Yes", "at": "2026-07-11T18:19:51Z" }
A Pidge channel conversation on iPhone: the agent's notifications and the human's replies in one thread, with delivery checkmarks on each message and a live 'listening now' indicator under the channel name

Every channel is also a chat: the human can message the agent first, replies wear WhatsApp-style checkmarks, and a green “listening now” shows when the agent is actually blocked waiting.

Send and block

pidge ask fires a notification and waits for the human’s tap. No webhook server, no polling loop to write — the answer prints as JSON on stdout.

Real deliverables

GitHub-style Markdown with tables, images on the banner, real file artifacts (xlsx, pdf, csv) the human previews and saves — not terminal scrollback.

The human owns loudness

Five delivery types from a quiet banner up to a real alarm that rings through silent mode and Focus. Per-channel ceilings; over-ceiling sends degrade loudly, never silently.

Safe approvals

Face ID-gated action buttons and a deny-default pidge approve exit-code gate, built for permission hooks. Optional per-channel end-to-end encryption.

Where to go

Section titled “Where to go”
  • Quickstart — from the app to a first answered notification in about a minute.
  • CLI — the full npx pidge-cli guide: sending, waiting, listening, multi-agent setups.
  • HTTP API — raw endpoints for any language: /notify, polling, webhooks, Live Activities.
  • Claude Code guide — the skill, the listen loop, and approval hooks.