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/.