Quick start

1. Launch the CLI

   reverse-api-engineer

   copy

   You land in a minimalist interactive prompt. Cycle between modes with Shift+Tab:

   • agent: autonomous AI browser agent (default)
   • manual: browser capture + AI generation (you drive)
   • engineer: re-process an existing capture
   • collector: AI-powered web data collection

2. Run your first manual capture

   Press Shift+Tab once to switch from agent mode to manual mode, then type a goal: what you want from the site.

   > fetch all apple jobs from their careers page

   copy

   The CLI opens a Chromium window. You browse, click, scroll, search: whatever exercises the requests you care about. Close the window when done. The AI takes over: it reads the HAR file, identifies the API surface, and emits a typed Python client.

   

3. Read the output

   Generated scripts are saved in two places:

   • ~/.reverse-api/runs/scripts/{run_id}
     • api_client.py
     • example_usage.py
     • README.md
   • ./scripts/apple_jobs_api
     • api_client.py
     • example_usage.py
     • README.md

   The first is canonical (permanent, indexed by run_id). The second is a local copy with a readable name, dropped right next to your project.

4. Run the generated client

   The generated script is just Python. Run it like any other:

   python scripts/apple_jobs_api/example_usage.py

   copy

   Or programmatically, via the CLI runner:

   reverse-api-engineer run <run_id> --file api_client.py \
     --no-interactive --auto-install

   copy

Next steps