Standalone CDP toolkit

# Browser automation for AI agents.

Drive real Chrome tabs from terminal commands, collect visible evidence, and run ChatGPT, Gemini, or Grok web sessions through a durable CLI workflow.

Install from npm Open developer docs

    npm install -g agbrowse
    agbrowse start --headed
    agbrowse navigate "https://chatgpt.com/"
    agbrowse snapshot --interactive
    agbrowse web-ai code \
      --vendor chatgpt \
      --model thinking \
      --effort standard \
      --prompt "Create a small CLI app with tests." \
      --output-zip ./result.zip

## Observe before acting.

### Browser primitives

Navigate, snapshot, click refs, type, resize, screenshot, inspect console output, and capture network evidence.

### Durable sessions

Web-ai sends return a session id so a later shell can poll the same provider tab after sleep or timeout.

### Code artifacts

ChatGPT code mode generates projects as zip files, then code-extract can recover old artifacts from the original conversation.

## Built for web UI agents, not hidden APIs.

agbrowse treats provider pages as changing user interfaces. The command surface keeps every mutation tied to an observed tab, target id, selector, screenshot, or artifact.

    SID=$(agbrowse web-ai send \
      --vendor chatgpt \
      --model pro \
      --inline-only \
      --prompt "Research and cite sources." \
      --json | jq -r .sessionId)

    agbrowse web-ai poll \
      --vendor chatgpt \
      --session "$SID" \
      --timeout 1800

## Generate first, recover later.

Start with `web-ai code` for a new build. Use `code-extract` later when the original ChatGPT conversation is still accessible and already contains `/mnt/data/*.zip` artifacts.

    agbrowse web-ai code \
      --vendor chatgpt \
      --model thinking \
      --effort standard \
      --prompt "Create a Flask MVP." \
      --output-zip ./result.zip

    DOWNLOAD: [result.zip](sandbox:/mnt/data/result.zip)
    MACHINE: /mnt/data/result.zip

    agbrowse web-ai code-extract \
      --vendor chatgpt \
      --url "https://chatgpt.com/c/<conversation-id>" \
      --output-zip ./result.zip

    unzip -t ./result.zip

## Release gates are explicit.

- Type and module checks: `npm run typecheck`, `npm run check:module-graph`.
- Capability truth checks: `npm run test:release-gates` and `npm run gate:all`.
- Runtime contracts: MCP, source audit, trace policy, fixture evals, and browser primitive tests.
- Remote Pages state: GitHub Pages publishes the repository `/docs` directory at `https://lidge-jun.github.io/agbrowse/`.