Repository navigation
rae 0.16.0 adds two backends:
- Codex: agent and engineer runs on OpenAI Codex.
- Hermes: engineer runs through the local
hermesCLI.
It also changes the session:
- Engineer mode shows the run it works on, and
/engineerpicks another one. - Text in the conversation can be selected and copied.
- Option+Delete deletes a word in the input bar.
Collector mode is removed, and a run's cost now adds up across re-engineers.
Published on PyPI. The attached wheel and source distribution are byte-for-byte identical to the PyPI files; SHA-256 checksums are attached.
pip install --upgrade reverse-api-engineer==0.16.0Codex users: install pip install --upgrade 'reverse-api-engineer[codex]', then sign in once with codex login or the Codex app. The collector extra no longer exists; drop it from your install command.
Added
hermesbackend:"sdk": "hermes"engineers a saved capture through the localhermesCLI (hermes chat --oneshot --format stream-json), so a run needs no API key in rae — the model, the provider and the authentication are the user's own Hermes configuration.hermes chatreads the prompt on stdin, so nothing the model reads is shell-parsed;hermes_max_turnsoverrides the turn cap from the user's Hermes config; runs start with--ignore-rulesso anAGENTS.md/CLAUDE.mdcannot steer them, and estimate cost from the CLI's token counts, leaving it at 0 for a model with no known price. The backend coversengineeronly: with"sdk": "hermes"theagentcommand stops before browser setup, so capture with another SDK (claude, opencode, copilot or cursor) and engineer that run with hermes;agent --dry-runreports the same error. The CLI is found onPATHor throughRAE_HERMES_BIN, andagent --dry-runreports it as a check.- Codex SDK backend (
sdk: "codex"): agent and engineer runs on OpenAI Codex through its Python SDK, on every agent provider. The session shows Codex's messages, reasoning summaries, plan, commands, file changes and browser steps as they happen,--json-streamemits them astool_start/tool_endevents, and/resumereopens a run's Codex thread. Install withpip install 'reverse-api-engineer[codex]', which brings its own Codex runtime, and sign in once withcodex loginor the Codex app. RAE runs Codex in its own home,~/.reverse-api/codex, whoseauth.jsonlinks to your Codex sign-in, so your Codex config, MCP servers, hooks, skills andAGENTS.md, and the apps connected to your ChatGPT account, don't steer the agent and RAE's runs stay out of your Codex history. Setcodex_hometo run in a Codex home as it is.codex_modelpicks the model (null, the default, uses your account's), and/settingslists the models your account offers.codex_effortpicks the reasoning effort, and/effortlists the levels the model offers. Like Claude, Codex reports the client it ran live, which shows the verified step and the client card.agent --dry-runchecks the SDK and the sign-in, and reportswould_run.model: nullwhen Codex picks the model. - Copy text from the session: the session takes the mouse for the wheel and for clicking files and links, so the terminal could not select its text. Dragging over the conversation now selects it and copies it to the clipboard when you let go, with
pbcopy,wl-copy,xcliporxsel, or through the terminal (OSC 52) otherwise and over SSH. A click without a drag still opens a link. - Engineer mode names the run it works on: the line above the input shows its id and prompt, by default your latest run with a HAR, and an engineer run's first line names the run it changes.
/engineer [run_id]picks another one among the runs that have a HAR. A choice holds until another run is engineered or a new agent run captures one.
Removed
- Collector mode: the
collectorcommand, the session's collector mode, thecollector_modelsetting and thecollectorinstall extra. rae stays on turning a site's traffic into an API client. Existing configs and histories still load: an oldcollector_modelis ignored, past collector runs stay in/history, and./collected/folders are left as they are.
Fixed
- Option+Delete in the session's input bar: it deleted a single character, and on an empty bar it stopped the run, because the terminal sends it as Esc then Delete and the session acted on Esc at once. Esc now waits 50 ms for what follows, so Option+Delete deletes the word before the cursor and Option+arrows sent as Esc b / Esc f jump by word, while a lone Esc still stops the run or closes a menu.
- A re-engineered run keeps its cost: its tokens and cost in
/history,listandshowadd up every re-engineer instead of keeping only the last, so a run's cost still counts its capture. - The client card shows what its own run cost, not the session's spend so far; the chip under the input still shows the session's.
/historyopened while a run wraps up waits for it, instead of listing that run's cost from before.- A slow page no longer ends a Chrome DevTools MCP run: a page that misses Chrome DevTools MCP's 10 second navigation timeout, as browserbase.com/careers does on a cold load, made the agent stop and ask the user to accept Chrome's connection prompt. The agent now opens the page again; only a timeout waiting for the browser connection means the prompt.
- Agent runs record their SDK:
history,showand replays in the session showed no SDK for agent runs, so a replayed card named the SDK the session was on. Runs now record it, and older runs read it from their SDK session. --modelwith another SDK:agentandengineeronly accepted Claude's model ids, so a Codex, OpenCode, Copilot or Cursor run could not pick its model per command. With anothersdkconfigured,--modelnow takes that SDK's own model id.- Leaving the session while a run stops: a second
ctrl+cwhile a run wraps up now quits once its cleanup is done, instead of repeating "still wrapping up", and actrl+cwhile rae waits for that cleanup on the way out still leaves the transcript in the terminal.