CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

browser-use

Fast, persistent browser automation via `browser-use` CLI (sessions persist across commands). Use for multi-step web workflows (open -> state -> click/input -> verify -> repeat). Supports chromium/headed, real Chrome (logged-in), and remote browser.

77

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

browser-use

Purpose

  • Persistent browser session across commands.
  • Element index workflow: state -> act by index.

When

  • Need quick multi-step browser automation without writing Playwright.
  • Need reuse logged-in Chrome session (real browser mode).
  • Need parallel sessions (--session).

Install

# one-off
uvx "browser-use[cli]" open https://example.com

# permanent
uv pip install "browser-use[cli]"
browser-use install  # downloads Chromium/deps

Core Loop

browser-use open https://example.com
browser-use state                 # list elements w/ indices
browser-use click 5
browser-use input 3 "hello"
browser-use screenshot
browser-use state                 # verify + get next indices
browser-use close

Modes

browser-use --browser chromium open <url>              # default (headless)
browser-use --browser chromium --headed open <url>     # visible window
browser-use --browser real open <url>                  # your Chrome (cookies/login)
browser-use --browser remote open <url>                # cloud browser (API key)

Common Commands

browser-use open <url>
browser-use state [--json]
browser-use click <idx> | dblclick <idx> | rightclick <idx> | hover <idx>
browser-use input <idx> "text" | type "text"
browser-use scroll up|down [n]
browser-use screenshot
browser-use get <what>                                # read page/element info
browser-use back | switch | close-tab
browser-use cookies export <path> | cookies import <path>
browser-use profile list|create|update|delete
browser-use sessions
browser-use server status|logs|stop
browser-use close [--all]

Sessions

browser-use --session work open https://work.example.com
browser-use --session personal open https://personal.example.com
browser-use --session work state
browser-use close --all

Rules (agent-friendly)

  • Always run browser-use state before acting; indices change after navigation.
  • After each navigation/submit: re-run state (don’t reuse stale indices).
  • Prefer --headed while debugging.
  • Cleanup: browser-use close (or close --all) when done.

Remote Mode

  • Env: BROWSER_USE_API_KEY (or --api-key).
Repository

marchatton/agent-skills

Path

.agents/skills/00-utilities/browser-use/SKILL.md

Revision

a0eadb2

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill