Browser

Summary

The Browser Agent completes tasks on the live web by driving a real Chromium browser. It uses a snapshot-and-selector loop — the model sees a stable list of interactive elements instead of brittle CSS — to navigate, click, and type. Reach for it to automate flows, scrape interactive pages, or test UIs.

Install

bunnpmpnpmyarn
$ pnpm dlx shadcn@latest add https://agentcn.vercel.app/r/eve/browser-agent.json
Copy

Composition

Copyagent/
├── agent.ts                  # Agent definition (model + config)
├── instructions.md           # Snapshot-then-act loop instructions
├── lib/
│   └── browser.ts            # Shared Playwright page + snapshot helper
└── tools/
    ├── browser_goto.ts       # Navigate to a URL
    ├── browser_snapshot.ts   # Read the current page + elements
    ├── browser_click.ts      # Click an element by selector
    └── browser_type.ts       # Type into an input by selector

Customization

• Use hosted browsers. Set BROWSER_CDP_URL to run against Browserbase or a remote Chrome.
• Richer snapshots. Extend lib/browser.ts to include roles, ARIA, or bounding boxes.
• Add actions. Add tools for scrolling, file uploads, or screenshots.
• Swap the model. Edit agent/agent.ts.