Skip to content

docs: update browser automation section with all tools in tested preference order#162

Merged
marcusquinn merged 3 commits intomainfrom
docs/readme-browser-automation-order
Jan 25, 2026
Merged

docs: update browser automation section with all tools in tested preference order#162
marcusquinn merged 3 commits intomainfrom
docs/readme-browser-automation-order

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Jan 24, 2026

Summary

  • Add 4 missing browser automation tools to README: Agent Browser, Dev-Browser, Playwriter, Sweet Cookie
  • Reorder all 9 tools by preference from OpenCode session testing
  • Add rationale paragraph explaining the preference order

Preference Order (from testing)

  1. Agent Browser (DEFAULT) - snapshot+ref pattern, deterministic, zero setup
  2. Dev-Browser - persistent state, 14% faster/39% cheaper than Playwright MCP
  3. Playwriter - existing sessions, 1 tool vs 17+, bypass detection
  4. Sweet Cookie - cookie extraction without browser launch
  5. Stagehand - natural language, self-healing (adds AI inference cost)
  6. Crawl4AI - web scraping/extraction
  7. Playwright - traditional cross-browser testing
  8. Chrome DevTools - debugging/performance
  9. Cloudflare Browser - server-side scraping

Why

The README's Browser Automation section was incomplete (missing 4 tools) and didn't reflect the preference order documented in .agent/tools/browser/browser-automation.md which was established through OpenCode session testing.

Changes

  • README.md - Updated Browser Automation section (13 insertions, 8 deletions)

Summary by CodeRabbit

  • Documentation
    • Reorganized Browser Automation tools section with preference-based ordering derived from testing experience.
    • Added detailed rationale explaining reliability, determinism, and latency considerations for tool selection.
    • Refined SEO & Research section presentation.

✏️ Tip: You can customize this high-level summary in your review settings.

…erence order

Add Agent Browser, Dev-Browser, Playwriter, and Sweet Cookie which were
missing. Reorder all tools by preference from OpenCode session testing:
Agent Browser (default, snapshot+ref), Dev-Browser (stateful), Playwriter
(existing sessions), Sweet Cookie (cookie extraction), Stagehand (NLP),
Crawl4AI (scraping), Playwright, Chrome DevTools, Cloudflare Browser.

Include rationale paragraph explaining why each tool ranks where it does
based on reliability, cost, and use-case fit for AI agents.
@gemini-code-assist
Copy link

Summary of Changes

Hello @marcusquinn, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the documentation for browser automation tools by incorporating additional options and re-evaluating their presentation. The primary goal is to provide users with a more complete and prioritized list, reflecting practical testing insights and offering clear guidance on tool selection based on specific use cases.

Highlights

  • New Browser Automation Tools: Four previously missing browser automation tools (Agent Browser, Dev-Browser, Playwriter, Sweet Cookie) have been added to the README.md.
  • Tool Preference Reordering: All nine browser automation tools are now reordered in the README.md based on their tested preference from OpenCode session testing.
  • Rationale for Preference Order: A new paragraph has been added to the README.md explaining the rationale behind the established preference order of the browser automation tools.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 24, 2026

Warning

Rate limit exceeded

@marcusquinn has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 3 minutes and 43 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Walkthrough

Updated the README.md's Browser Automation section with a preference-based tool ordering and explanatory rationale. Introduced new tools (Agent Browser, Dev-Browser, Playwriter, Sweet Cookie) and reordered existing ones with expanded descriptions based on reliability, determinism, and latency considerations.

Changes

Cohort / File(s) Summary
Browser Automation Documentation
README.md
Restructured Browser Automation section into a preference-ordered list with rationale explanations. Added Agent Browser, Dev-Browser, Playwriter, and Sweet Cookie; reordered Stagehand, Crawl4AI, Playwright, Chrome DevTools, and Cloudflare Browser Rendering. Added "Why this order" subsection detailing reliability, determinism, and latency factors.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🤖 From scattered tools to ordered chains,
Agent Browser leads the way today,
Each preference pruned with care and grace,
Reliability over the tangled mess,
Our docs now gleam with purpose bright! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and specifically describes the main change: updating the browser automation section with tools reordered by tested preference.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 406 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sat Jan 24 02:51:34 UTC 2026: Code review monitoring started
Sat Jan 24 02:51:34 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 406
Sat Jan 24 02:51:35 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sat Jan 24 02:51:37 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 406
  • VULNERABILITIES: 0

Generated on: Sat Jan 24 02:52:53 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request is a valuable documentation update, adding several new browser automation tools to the README and reordering them based on testing. The added rationale for the preference order is very helpful for users to make informed decisions. I've provided one suggestion to improve the readability and scannability of the new list by restructuring the dense descriptions into sub-bullets, which should make the features of each tool clearer.

README.md Outdated
Comment on lines 705 to 713
- [Agent Browser](https://github.com/vercel-labs/agent-browser) - **DEFAULT** - CLI-first headless automation optimized for AI agents (Rust CLI + Node.js daemon, snapshot+ref pattern for deterministic element targeting, multi-session isolation, zero setup)
- [Dev-Browser](https://github.com/SawyerHood/dev-browser) - Stateful TypeScript API with persistent Playwright server (14% faster, 39% cheaper than Playwright MCP; pages/cookies/auth survive across script executions; ideal for local dev testing)
- [Playwriter](https://github.com/remorses/playwriter) - Chrome extension MCP with full Playwright API (reuse existing browser sessions/extensions/cookies, bypass automation detection, single `execute` tool vs 17+ for minimal context bloat)
- [Sweet Cookie](https://github.com/steipete/sweet-cookie) - Browser cookie extraction for API calls without launching a browser (TypeScript cross-platform + Swift macOS native; reads cookies directly from browser profile DBs)
- [Stagehand](https://github.com/browserbase/stagehand) - AI-powered natural language browser automation with self-healing selectors (JavaScript + [Python](https://github.com/anthropics/stagehand-python) versions; `act`/`extract`/`observe`/`agent` primitives)
- [Crawl4AI](https://github.com/unclecode/crawl4ai) - Async web crawler optimized for AI content extraction and bulk scraping
- [Playwright](https://playwright.dev/) - Cross-browser testing and automation (traditional selector-based approach)
- [Chrome DevTools](https://chromedevtools.github.io/devtools-protocol/) - Browser debugging, performance analysis, DOM inspection
- [Cloudflare Browser Rendering](https://developers.cloudflare.com/browser-rendering/) - Server-side web scraping via Cloudflare Workers

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This is a great update that adds more tools and a helpful preference order. The descriptions are very informative.

To improve scannability and readability, I suggest restructuring the list items with long descriptions to use sub-bullets. This makes the key features of each tool easier to digest at a glance.

I've also capitalized the start of each sub-point for consistency. Here is a suggested refactoring:

- [Agent Browser](https://github.com/vercel-labs/agent-browser) - **DEFAULT** - CLI-first headless automation optimized for AI agents
  - Rust CLI + Node.js daemon
  - Snapshot+ref pattern for deterministic element targeting
  - Multi-session isolation
  - Zero setup
- [Dev-Browser](https://github.com/SawyerHood/dev-browser) - Stateful TypeScript API with persistent Playwright server
  - 14% faster, 39% cheaper than Playwright MCP
  - Pages, cookies, and auth survive across script executions
  - Ideal for local dev testing
- [Playwriter](https://github.com/remorses/playwriter) - Chrome extension MCP with full Playwright API
  - Reuse existing browser sessions, extensions, and cookies
  - Bypasses automation detection
  - Single `execute` tool vs 17+ for minimal context bloat
- [Sweet Cookie](https://github.com/steipete/sweet-cookie) - Browser cookie extraction for API calls without launching a browser
  - TypeScript cross-platform + Swift macOS native
  - Reads cookies directly from browser profile DBs
- [Stagehand](https://github.com/browserbase/stagehand) - AI-powered natural language browser automation with self-healing selectors
  - JavaScript + [Python](https://github.com/anthropics/stagehand-python) versions
  - `act`/`extract`/`observe`/`agent` primitives
- [Crawl4AI](https://github.com/unclecode/crawl4ai) - Async web crawler optimized for AI content extraction and bulk scraping
- [Playwright](https://playwright.dev/) - Cross-browser testing and automation (traditional selector-based approach)
- [Chrome DevTools](https://chromedevtools.github.io/devtools-protocol/) - Browser debugging, performance analysis, DOM inspection
- [Cloudflare Browser Rendering](https://developers.cloudflare.com/browser-rendering/) - Server-side web scraping via Cloudflare Workers

Add 6 missing MCP servers to the 'All Supported MCPs' table:
- FluentCRM (WordPress CRM)
- osgrep (local semantic search)
- Peekaboo (macOS GUI automation)
- Playwriter (Chrome extension MCP)
- WordPress MCP Adapter (official WP MCP)
- Move llm-tldr to alphabetical position

Also alphabetize the table, add Peekaboo to Browser Automation category,
add WordPress MCP Adapter and new CRM & Marketing category section.
@augmentcode
Copy link

augmentcode bot commented Jan 24, 2026

🤖 Augment PR Summary

Summary: Updates the README’s Browser Automation section to include four additional tools and reorder the full list by tested preference.
Why: Aligns the README with OpenCode session findings and the documented ordering in .agent/tools/browser/browser-automation.md.

🤖 Was this summary useful? React with 👍 or 👎

Copy link

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 1 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

README.md Outdated
- [Cloudflare Browser Rendering](https://developers.cloudflare.com/browser-rendering/) - Server-side web scraping
**Browser Automation** (in order of preference, tested in OpenCode sessions):

- [Agent Browser](https://github.com/vercel-labs/agent-browser) - **DEFAULT** - CLI-first headless automation optimized for AI agents (Rust CLI + Node.js daemon, snapshot+ref pattern for deterministic element targeting, multi-session isolation, zero setup)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agent Browser is described as “zero setup”, but the repo’s own guidance indicates a one-time install + Chromium download step (e.g., agent-browser install). Consider clarifying what “zero setup” means here (e.g., no server/config) so readers don’t expect it to run without installation.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 406 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sat Jan 24 02:55:06 UTC 2026: Code review monitoring started
Sat Jan 24 02:55:06 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 406
Sat Jan 24 02:55:06 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sat Jan 24 02:55:08 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 406
  • VULNERABILITIES: 0

Generated on: Sat Jan 24 02:56:21 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

- Keep main's tiered MCP table structure (Global vs Per-agent)
- Keep main's benchmarked browser automation section with anti-detect stack
- Add Peekaboo and Sweet Cookie from PR to browser automation
- Add FluentCRM and CRM & Marketing category from PR
- Keep WordPress MCP Adapter from both (already in main)
@sonarqubecloud
Copy link

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 479 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 25 02:24:00 UTC 2026: Code review monitoring started
Sun Jan 25 02:24:01 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 479
Sun Jan 25 02:24:01 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 25 02:24:03 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 479
  • VULNERABILITIES: 0

Generated on: Sun Jan 25 02:25:23 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@marcusquinn marcusquinn merged commit 7d43216 into main Jan 25, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant