Install the CLI

The @birdybeep/cli is the open-source command that pairs a machine, installs the harness adapters, and sends events. It is MIT-licensed — read exactly what it does before you run it.

Install

npm i -g @birdybeep/cli

It's a small Node package. Install it globally so birdybeep is on your PATH.

Requirements

Node 20 or newer.
The BirdyBeep app installed and signed in (to scan the pairing QR).
At least one supported harness — Claude Code, Codex, OpenCode, or Cursor — on the machine.

Verify

birdybeep --version
birdybeep doctor   # checks environment, pairing, and harness detection

Next, pair your machine, then install your integrations.