Skip to content

v0.16.0 - Codex and Hermes backends, engineer mode names its run

Latest

Choose a tag to compare

@kalil0321 kalil0321 released this 15 Nov 12:01
· 1 commit to main since this release
e3aae74

rae 0.16.0 adds two backends:

  • Codex: agent and engineer runs on OpenAI Codex.
  • Hermes: engineer runs through the local hermes CLI.

It also changes the session:

  • Engineer mode shows the run it works on, and /engineer picks 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.0

Codex 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

  • hermes backend: "sdk": "hermes" engineers a saved capture through the local hermes CLI (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 chat reads the prompt on stdin, so nothing the model reads is shell-parsed; hermes_max_turns overrides the turn cap from the user's Hermes config; runs start with --ignore-rules so an AGENTS.md/CLAUDE.md cannot steer them, and estimate cost from the CLI's token counts, leaving it at 0 for a model with no known price. The backend covers engineer only: with "sdk": "hermes" the agent command stops before browser setup, so capture with another SDK (claude, opencode, copilot or cursor) and engineer that run with hermes; agent --dry-run reports the same error. The CLI is found on PATH or through RAE_HERMES_BIN, and agent --dry-run reports 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-stream emits them as tool_start/tool_end events, and /resume reopens a run's Codex thread. Install with pip install 'reverse-api-engineer[codex]', which brings its own Codex runtime, and sign in once with codex login or the Codex app. RAE runs Codex in its own home, ~/.reverse-api/codex, whose auth.json links to your Codex sign-in, so your Codex config, MCP servers, hooks, skills and AGENTS.md, and the apps connected to your ChatGPT account, don't steer the agent and RAE's runs stay out of your Codex history. Set codex_home to run in a Codex home as it is. codex_model picks the model (null, the default, uses your account's), and /settings lists the models your account offers. codex_effort picks the reasoning effort, and /effort lists 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-run checks the SDK and the sign-in, and reports would_run.model: null when 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, xclip or xsel, 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 collector command, the session's collector mode, the collector_model setting and the collector install extra. rae stays on turning a site's traffic into an API client. Existing configs and histories still load: an old collector_model is 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, list and show add 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.
  • /history opened 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, show and 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.
  • --model with another SDK: agent and engineer only accepted Claude's model ids, so a Codex, OpenCode, Copilot or Cursor run could not pick its model per command. With another sdk configured, --model now takes that SDK's own model id.
  • Leaving the session while a run stops: a second ctrl+c while a run wraps up now quits once its cleanup is done, instead of repeating "still wrapping up", and a ctrl+c while rae waits for that cleanup on the way out still leaves the transcript in the terminal.