› cavi-ai/
GitHub ↗

Quickstart

Connect an agent host to bobby and run a first browsing workflow. This takes a few minutes after installation.

1. Pair Firefox

Skip this step if you use Chromium.

bash
bobby install --companion
bobby firefox-start

Click Bobby Companion in the Firefox toolbar, then Pair. See Firefox companion.

2. Check the setup

bash
bobby doctor

A healthy report has no fail lines. When something fails, the report starts with the repair command, usually bobby doctor --fix.

Restart your agent host so it loads the new MCP server.

3. Run a workflow

Ask the agent to open a page. It makes these MCP calls:

  1. workflow_start with {"profile": "default", "url": "https://example.com", "includePostState": true} creates a session, a page and a workflow, and returns a workflowHandle plus bounded initial page state.
  2. Reuse postState when postStateStatus.status is available. If it is unavailable, inspect its code before another read. workflow_observe with {"workflowHandle": "<handle>"} reads the current page when authorized. Omitting includePostState keeps startup free of the extra observation.
  3. click, type_text, navigate, or an intent_* tool acts on a target. Pass workflowHandle on each call.
  4. session_close releases the browser when the work is done.

The start_browsing MCP prompt teaches an agent this loop. Tool parameters are in MCP tools.

Next