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

• Sessions sync event-first — trigger a new event (a prompt, approval, or restart) to surface a running session.
• Codex: run /hooks once to grant trust; until then it shows needs trust.
• OpenCode: restart OpenCode once so the plugin loads.
• Re-run birdybeep agent install all — it's idempotent and re-detects harnesses.