The Beeper CLI built for agents
bpr wraps Beeper Desktop in short stable ids, output that flips to JSON when piped, structured errors with hints, and a one-shot prime contract — everything an LLM needs to drive your chats.
go install github.com/doublej/bpr@latest Orient in one shot
prime prints the whole contract — commands, id shapes, output rules — so an agent needs no second prompt.
What it does
Short stable ids
Every record gets a CHT-/MSG-/ACC-/USR- handle. Raw Matrix ids are accepted but never shown — they cannot structurally reach the agent.
JSON when piped
A dense table on a TTY, machine JSON the moment output is redirected. No --json flag to remember; the pipe is the signal.
Compact query syntax
from:me, has:media|image|file, is:group, after:7d — mixed freely with literal search words and ranked by relevance.
Structured errors
Failures carry a code, a message, and an actionable hint — and map to a stable exit code so scripts can branch.
The prime contract
One command emits the full agent-orientation document in Markdown or JSON. Drop it into a system prompt and go.
Watch, no daemon
Subscribe to a chat, then watch check returns only messages newer than your last check. Pull-style — bpr stays one-shot.
Ready to start?
go install github.com/doublej/bpr@latestNeeds Beeper Desktop running with BEEPER_ACCESS_TOKEN set · GitHub · MIT License