## Use fastbrowse with your agent

The [fastbrowse skill](https://github.com/agent-labs-dev/fastbrowse/blob/4372bfd6bb8ff39f7b14b1cbb7dba2285b9761d5/../skills/fastbrowse/SKILL.md) lets an agent that supports Agent Skills delegate a website task to fastbrowse
and interpret its status and citations. It prefers an existing local Chrome connection, then local Chrome.
It uses an MCP server configured for that browser choice, or the CLI. Cloud browsing is available when requested or local browsing is unavailable.
Agents without skill support can use the CLI or MCP server directly.
Installing the skill installs instructions; the browser and model credentials still need configuration.

### Install

From a checkout of this repository, install the skill for your agent with the
[Skills CLI](https://github.com/vercel-labs/skills):

```sh
npx skills add ./ --skill fastbrowse
```

The same installer can fetch the skill from GitHub without a checkout:

```sh
npx skills add agent-labs-dev/fastbrowse --skill fastbrowse
```

Choose your agent when the installer prompts. The installer uses project scope by default.
Add `--global` for all projects, or `--agent codex claude-code` to select those two agents explicitly.
Review the skill before installing it. For a manual install, copy `skills/fastbrowse` into
`.agents/skills/fastbrowse` for Codex or `.claude/skills/fastbrowse` for Claude Code in the project where you
want to browse. Keep its `references` directory beside `SKILL.md`. Personal installs use
`~/.agents/skills/fastbrowse` or `~/.claude/skills/fastbrowse`. Start a new agent session after installation.

### Configure and use

Install [uv](https://docs.astral.sh/uv/getting-started/installation/) for the CLI path. Set `OPENROUTER_API_KEY`
in the calling process environment or a local `.env`, outside the conversation. Local Chrome is the skill
default and needs only the model key. Add `BROWSER_USE_API_KEY` for cloud browsing. An existing DevTools
connection reuses your Chrome; `--local` without a connection starts a separate browser.
The [CLI guide](https://github.com/agent-labs-dev/fastbrowse/blob/4372bfd6bb8ff39f7b14b1cbb7dba2285b9761d5/../README.md#try-it) covers browser profiles, secrets, and budgets.
For MCP, use the [server setup](https://github.com/agent-labs-dev/fastbrowse/blob/4372bfd6bb8ff39f7b14b1cbb7dba2285b9761d5/../README.md#use-it-from-an-mcp-client) instead; credentials belong to the server's environment.

In Codex:

```text
Use $fastbrowse to find the top story on https://news.ycombinator.com/ and return its title with a citation.
```

In Claude Code:

```text
/fastbrowse Find the top story on https://news.ycombinator.com/ and return its title with a citation.
```

The skill also supports automatic selection from its description. It uses the CLI's uncapped resource
defaults unless you supply limits or an existing task budget requires them. MCP server ceilings still apply.
Cloud browser charges are added when the browser stops, separately from any model-spend cap.

For a form, include its URL and the values to fill. State whether the agent should stop before submission or
submit the specified content. The skill does not authorize writes on its own. A result of `complete` means
the task was verified; other statuses describe the missing input, authorization, evidence, or access.