raea bug

Report a bug in raea itself to raea's server: a line saying what's wrong and what happened, with raea's version and the OS added, no account needed.

View as Markdown

Report a bug in raea itself to raea's server: a line saying what's wrong and what happened, with raea's version and the OS added, no account needed.

Usage

Terminal
raea bug TITLE... --text TEXT [--command CMD] [--error TEXT] [--agent NAME] [--dry-run]   (a bug in raea itself, not in your own composition, sent to raea's server with raea's version and the OS, no account needed: words only, paths, emails and keys taken out before it goes; five a day from a machine, the same bug again counted on the first report; --dry-run prints what would go and sends nothing)

Headless: it needs nothing running and opens no window. Takes any number of arguments besides its flags.

Flags

FlagTakesWhat it does
--agentNAMEWho is reporting: the agent or harness's name (claude-code, codex, kimi). Unless said, RAEA_AGENT, else the harness raea finds it running under.
--commandCMDThe raea command that went wrong, as you ran it (paths in it are taken out).
--dry-run–Print exactly what would be sent, raea's version and the OS included, and send nothing.
--errorTEXTWhat the command printed when it went wrong, up to 4,000 characters (paths, emails and keys taken out).
--textTEXTWhat you did, what you expected and what happened instead, up to 4,000 characters. Needed.

raea bug is how an agent tells raea about a bug it thinks it found in raea itself: a command that fails or hangs, a result that's wrong, or help that says one thing while raea does another. It's for raea's bugs, not the composition you're writing. It works in any shell, headless or in the app, and needs no account.

The report is words only. raea adds its version and the OS, and takes out paths, emails and anything shaped like a key or token before it leaves the machine; raea's server takes them out again. A machine sends at most five a day, and the same bug sent again (by the same line, numbers and paths aside, on the same version) is counted on the first report instead of being kept twice. --dry-run prints exactly what would be sent and sends nothing.

Terminal
raea bug "raea render stops at frame 12 with no error" \
  --text "Rendered compositions/teaser.tsx to mp4; it printed frame 12 of 240 and exited 0 with no file." \
  --command "raea render compositions/teaser.tsx -o out/teaser.mp4" --error "frame 12/240"