auto-reverse

Conversational CLI that reverse-engineers a website's API: an LLM drives a headed browser while an embedded mitmproxy captures real traffic and documents it into a live OpenAPI spec + markdown.

Runtime

Built on standard CPython 3.14 (managed via uv).

Note on free-threading: an earlier iteration targeted free-threaded 3.14 (3.14t), but mitmproxy cannot run there yet — its aioquic and mitmproxy-rs dependencies only ship Limited-API (abi3) wheels, which the free-threaded build rejects, and source builds fail. Since auto-reverse's concurrency is entirely I/O-bound (an asyncio proxy loop, an agent loop waiting on network/LLM, and Playwright running as a separate Node subprocess), free-threading offered no practical benefit here. The project therefore targets standard CPython 3.14.

Setup

uv sync
uv run playwright install chromium

Usage

ANTHROPIC_API_KEY=... uv run auto-reverse https://example.com

(Full usage, flags, and REPL commands are documented as the CLI lands.)