How suchi-bits/agent-browser works
agent-browser is a Rust browser-automation CLI for AI agents. Its principal workflow is command-line input → command parsing → daemon connection → browser control over CDP → structured output; README capabilities include interaction, snapshots, screenshots, chat, and runtime streaming. The repository also includes a dashboard, installation and diagnostics, and an evaluation runner. Some runtime wiring is unsampled, so those connections are omitted or marked unverified rather than inferred.
Main entry points: main.rs CLI entry · run.ts Eval runner · mod.rs Runtime streaming · actions.rs Browser actions
Components 29
CLI and setup
- CLI entry
cli/src/main.rs - Command parser
cli/src/commands.rs - CLI options
cli/src/flags.rs - Result formatting
cli/src/output.rs - Daemon connection
cli/src/connection.rs - Browser installer
cli/src/install.rs - Diagnostics
cli/src/doctor/mod.rs - AI chat
cli/src/chat.rs - Agent skills
cli/src/skills.rs
Browser runtime
- Native daemon
cli/src/native/daemon.rs - Browser actions
cli/src/native/actions.rs - Session state
cli/src/native/state.rs - CDP transport
cli/src/native/cdp/client.rs - Browser discovery
cli/src/native/cdp/discovery.rs - Chrome control
cli/src/native/cdp/chrome.rs - Page storage
cli/src/native/storage.rs
Streaming and dashboard
- Runtime streaming
cli/src/native/stream/mod.rs - Stream chat
cli/src/native/stream/chat.rs - Stream HTTP
cli/src/native/stream/http.rs - CDP stream loop
cli/src/native/stream/cdp_loop.rs - Dashboard UI
packages/dashboard/src/app/page.tsx
Evaluation
- Eval runner
evals/run.ts - Claude provider
evals/lib/claude.ts - Codex provider
evals/lib/codex.ts - Eval judge
evals/lib/judge.ts - Eval reporting
evals/lib/reporter.ts
Other components
- Agent or user
- Chrome browser
- AI model gateway
Connections 29
- Agent or user → CLI entry: runs commands
README.md - CLI entry → Command parser: parses commands
cli/src/main.rs - CLI entry → Daemon connection: sends commands
cli/src/main.rs - CLI entry → CLI options: reads options
cli/src/main.rs - CLI entry → Result formatting: formats results
cli/src/main.rs - CLI entry → Browser installer: installs browser
cli/src/main.rs - CLI entry → Diagnostics: runs diagnostics
cli/src/main.rs - CLI entry → AI chat: starts chat
cli/src/main.rs - CLI entry → Agent skills: loads skills
cli/src/main.rs - Chrome browser → Browser installer: downloaded by
README.md - Daemon connection → Native daemon: connects to
- Native daemon → Browser actions: dispatches actions
- Browser actions → CDP transport: controls browser
- Chrome control → Browser discovery: discovers browsers
cli/src/native/cdp/chrome.rs - Chrome control → CDP transport: uses transport
- Browser actions → Session state: uses session state
- Page storage → CDP transport: evaluates storage
cli/src/native/storage.rs - AI chat → Stream chat: uses chat stream
cli/src/chat.rs - Runtime streaming → CDP stream loop: starts stream loop
cli/src/native/stream/mod.rs - Runtime streaming → Stream chat: provides chat stream
cli/src/native/stream/mod.rs - Runtime streaming → Stream HTTP: provides HTTP
cli/src/native/stream/mod.rs - Runtime streaming → Dashboard UI: serves dashboard
- Agent or user → Eval runner: runs evaluations
- Eval runner → Claude provider: selects provider
evals/run.ts - Eval runner → Codex provider: selects provider
evals/run.ts - Eval runner → Eval judge: evaluates response
evals/run.ts - Eval runner → Eval reporting: reports results
evals/run.ts - Claude provider → AI model gateway: calls gateway
evals/lib/claude.ts - Codex provider → AI model gateway: calls gateway
evals/lib/codex.ts