Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/epiral/bb-browser/agents-mdgit clone --depth 1 https://github.com/epiral/bb-browserWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.02522 | $0.02522 |
| Opus 5 | $0.01261 | $0.01261 |
| Sonnet 5 | $0.00504 | $0.00504 |
| Haiku 4.5 | $0.00252 | $0.00252 |
Grade A, and why
bb-browser AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 208 lines — stays where its author put it; the contents beside it link to each section on GitHub.
bb-browser Agent 开发规范
架构
CLI ──HTTP──▶ Daemon ──controlConn CDP──▶ Chrome
│
│ --hub 模式 (可选)
├── Hub ProviderStream ──▶ Pinix Hub
│
│ Protocol 2
└── Streamer (bb-viewer) ──captureConn + inputConn CDP──▶ Chrome
│
└── WebRTC video + DataChannel ──▶ Clip Web UI
三根 CDP 连接到同一个 Chrome：
| 连接 | Owner | 职责 |
|---|---|---|
| controlConn | daemon | Agent 操作：tab/nav/site/DOM/click-by-ref |
| inputConn | streamer | Human 实时输入：鼠标/键盘/IME (DataChannel → CDP) |
| captureConn | streamer | 视频流：screencast → VP8 → WebRTC |
组件：
| 组件 | 位置 | 职责 |
|---|---|---|
| CLI | packages/cli/ |
命令行入口，HTTP 调 daemon |
| Daemon | packages/daemon/ |
控制中心：CDP controlConn、HTTP API、Hub 连接、site 执行、streamer 管理 |
| Shared | packages/shared/ |
统一命令定义 (commands.ts)、协议类型 (protocol.ts) |
| Streamer | bb-viewer repo |
纯视频 + 实时输入（Go binary，daemon 子进程） |
Daemon 两种模式
# 本地模式：Agent 用 CLI 操作浏览器
bb-browser daemon start
# Hub 模式：注册到 Pinix Hub，远程可用
bb-browser daemon start --hub https://hub.pinixai.com --hub-token xxx
协议
Protocol 1: CLI ↔ daemon (POST /command)
请求：{"method": "snap", "params": {"tab": "3ef9"}}
成功：{"result": {"tab": "3ef9", "title": "Google", "snapshot": "..."}}
失败：{"error": {"message": "Missing --tab", "hint": "Run 'bb-browser tab list'"}}
Protocol 2: daemon ↔ streamer (POST /command)
| Method | Params | 说明 |
|---|---|---|
| connect | {cdpUrl, ice?} | 连接 CDP，创建 WebRTC peer |
| answer | {answer_sdp, candidates} | 完成 WebRTC 信令 |
| switch | {cdpUrl} | 切到新 tab（peer 不变） |
| stop | {} | 停止 |
统一命令定义
packages/shared/src/commands.ts 是所有命令的单一定义源。每个命令包含 method、group、description、requiresTab、params。CLI 解析、daemon dispatch、Hub 注册都从这里读取。
添加新命令：
commands.ts— 添加 CommandDefprotocol.ts— 添加 ActionTypecommand-dispatch.ts— 添加处理分支packages/cli/src/commands/<name>.ts+index.ts— CLI 命令
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 208 lines · 2,522 tokens per session scan A 67667ad433d6
bb-browser AGENTS.md is an instructions file published in the GitHub repository epiral/bb-browser (6,162 stars, last pushed 3mo ago), licensed MIT. It adds 2,522 tokens to every session, about $0.0126 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
Browser4 CLAUDE.md
Instructions for platonai/Browser4, covering browser4 — project context for claude, architecture, key dispatch chain (cli → browser), batch commands and e2e test structure.
deepseekCLI CLAUDE.md
Instructions for cynchro/deepseekCLI, covering tarea actual, progreso, decisiones clave, próximos pasos and contexto importante.
deckforge AGENTS.md
Instructions for tph-kds/deckforge, covering deckforge agent entry point, code intelligence, read order, default routing and non-negotiable implementation rules.
fast-browser CLAUDE.md
Claude Code instructions for m4ttstack/fast-browser, covering fast browser plugin, where a change belongs, fork branch: use fast-browser-runtime, releasing a new runtime and re-pinning this repo: use the script.
agentoscope AGENTS.md
Instructions for rafaelcg/agentoscope, covering agentoscope — agent instructions, what this is, layout, commands and conventions.
sendblue-browser-use AGENTS.md
Instructions for sendblue-api/sendblue-browser-use, covering agents.md — sendblue-browser-use, what this repo is, setup, common commands and health (no auth).