Getting started

BirdyBeep sends a push to your phone when your coding agents need you — approval, input, finished, idle, or failed. Pair a machine once, install the integrations, then walk away.

What it is

BirdyBeep is a notify-only layer for agentic coding harnesses (Claude Code, Codex, OpenCode, Cursor). It watches lifecycle events your harness already emits — there's no background daemon and nothing polling your terminal. Sessions sync event-first: a session appears the moment it emits its next event after install.

Three commands, then walk away

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

That's it. Future sessions from every installed harness 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, or cursor — per-harness setup