Developer docs
Agent reports
Turn meaningful outcomes from coding agents, monitors, scheduled jobs, and standups into a private audio briefing. AudioReality receives bounded reports; it never operates the systems that sent them.
Start in 30 seconds
Create or reveal a show token in Settings → Agents, then verify it from your terminal.
export AUDIOREALITY_TOKEN=ar_show_...
npx -y @audioreality/cli doctorUse the Report v1 contract directly, or choose the integration that matches where your work already runs.
Choose an integration
- Report v1 contractFields, limits, ingestion responses, idempotency, and a working curl request.
- MCPRun the local stdio server from any MCP-compatible agent.
- CLISubmit reports, inspect a show, and render a Brief from the terminal.
- Claude CodeInstall the MCP server, portable skill, and reporting instruction.
- CursorConfigure the MCP server and summary-only project rule.
- CodexAdd the stdio MCP server and portable reporting skill.
- GitHub ActionsReport every job outcome with the composite action.
- Pizza BotChoose the reviewed plugin path or the full read-only bridge.
- Privacy and securityWhat leaves the machine, what is retained, and what AudioReality cannot do.
Status lifecycle
okWork completed cleanly.
warnWork completed with degradation, partial output, or a recovered issue.
failWork did not complete or a required check failed.
needs_decisionProgress is blocked on a human choice or approval.
Give a run a stable run_id. A later status for that same source and run supersedes the earlier report, resolving a pending decision.
Privacy baseline
Only submitted fields leave the machine. Details are disabled by default, content is purged after 14 days, raw text never enters evergreen memory, and AudioReality never trains on it.