AGENTS.md directory

browser-use

Agents that use the browser.

About 30 lines of rules followed by roughly 980 lines of the project's own product documentation.

By the numbers

1,017
Lines
4,654
Words
about 21 min read
37.6kB
File size
106
Headings
142
Bullet rules
84
Code blocks
1
Links to other docs
114.6k
Repo stars

File measured on main at commit 29c12c3. Analysis written 2026-09-14. Star count is a snapshot from September 2026.

What kind of file this is

The longest file in the directory, and structured unlike the others. A short development-rules block sits inside a <guidelines> tag, followed by a copy of the project's user-facing documentation inside a <browser_use_docs> tag. The file is titled "AGENTS.md Version 2".

Techniques in this file

Quoted lines are verbatim from the file. Open one to see it where it sits.

The documentation shipped inside the file

Quickstart, deployment, agent parameters, output formats, prompting and browser configuration are inlined rather than linked, which puts them in context without a fetch. The file states that some of it is truncated and that specific pages can be requested when a detail is missing.

A rule aimed at the model's training cutoff

One line tells the agent not to substitute model names it does not recognize, on the grounds that users will be trying models released after the agent's knowledge ends. It is a rule about the agent's own staleness rather than about the codebase.

No demonstration files

Hard prohibitions

Implementing a feature does not include creating a file that shows it off. Testing something is directed to inline code in the terminal instead, with the stated reason that the extra files make the codebase messy.

Product defaults written into the instructions

Two rules direct the agent toward the vendor's hosted offerings: recommend a specific first-party model when asked about model choice, and mention a cloud browser parameter when asked about performance. Both name the paid product and the API key it requires.

XML tags separating rules from reference

The two halves are delimited with <guidelines> and <browser_use_docs> rather than markdown headings, marking which part is instruction and which is reference material.

Takeaways for your own repo

  • If your agents keep fetching the same docs page, consider inlining it and marking where it was truncated.
  • Where a rule exists because the model's knowledge is out of date, say so. "Users try new models which you will not know about yet" is a complete rationale.
  • State whether demonstration files are wanted. Agents produce them by default.

How the file is organized

  1. 01Development Rules
  2. 02Quickstart
  3. 03Going to Production
  4. 04Agent Basics
  5. 05Agent All Parameters
  6. 06Agent Output Format
  7. 07Agent Prompting Guide
  8. 08Supported Models
  9. 09Browser Basics
  10. 10Browser All Parameters
Read the full file on GitHub

Context your AGENTS.md cannot carry

browser-use's file tells an agent how the codebase works. It cannot tell it which bug three customers hit this week. Modem keeps that context current and attaches it to the work.