Getting started

BirdyBeep notifies your phone when a coding agent needs input or approval, finishes, fails, or goes idle. Set it up once on each machine.

What it is

BirdyBeep connects to Claude Code, Codex, OpenCode, Cursor, and GitHub Copilot CLI through their existing hooks. It sends a notification when a session changes state. It does not poll or watch your terminal.

Set up a machine

From a machine with your agents installed:

npm i -g @birdybeep/cli   # install the open-source cli
birdybeep pair           # scan the qr from the app — once per machine
birdybeep agent install all # configure every harness it finds

Future sessions from every installed coding agent on this machine appear in the app automatically.

Next steps

install the cli — details and requirements
pair your machine — how the QR pairing works
claude code, codex, opencode, cursor, or github copilot cli — per-harness setup