Troubleshooting

Run doctor first

birdybeep doctor
# checks pairing, hook/plugin config, and push delivery end to end

birdybeep doctor pinpoints which step is broken and prints the fix.

No beeps arriving

• Confirm push permission is enabled for the BirdyBeep app on your phone.
• Send a known-good test: birdybeep test.
• Check your notification preferences in the app aren't muting the category or machine.
• Free plan has a monthly beep quota — confirm you haven't hit it.

Sessions not appearing

• An existing session appears after its next event. Send a prompt, trigger an approval request, resume it, or restart it.
• Codex: run /hooks once to grant trust; until then it shows needs trust.
• OpenCode: restart OpenCode once so the plugin loads.
• You can run birdybeep agent install all again safely; it scans for supported coding agents each time.