Get Started

Octowright is built for development and testing workflows where browser behavior involves multiple users, engines, or roles.

Use this path to go from first run to repeatable verification:

1. Install Octowright and browser engines.
2. Register Octowright as an MCP server.
3. Run a short smoke flow.
4. Save the flow as a macro.
5. Run scenario verification and emit JUnit.

1. Install

git clone https://github.com/livingstaccato/octowright.git
cd octowright
uv sync
uv run playwright install chromium firefox webkit

2. Register with your MCP client

Use the same server command in your MCP config:

{
  "mcpServers": {
    "octowright": {
      "command": "uv",
      "args": ["--directory", "/abs/path/to/octowright", "run", "octowright", "serve"]
    }
  }
}

3. Smoke test (launch, drive, list, close)

1. Call browser_launch with kind=webkit and url=https://example.com.
2. Call browser_click_by on link text More information.
3. Call browser_list and confirm one live instance.
4. Call browser_close using the returned instance_id.

4. Save as a macro

Capture the flow once and replay it later:

• Save with macro_save
• Re-run with macro_run

5. Run verification as tests

Use scenario verify hooks and emit JUnit for CI:

uv run octowright scenario start verify-suite --test --out artifacts/verify-suite.xml
uv run octowright test --tag verify --out artifacts/macro-tests.xml

Next

• Demos for recorded proof bundles.
• Docs for deeper scenario, macro, and CI details.
• GitHub for the full reference.