Bladebro

Stealthy and efficient agentic browser driver for AI agents. Few tools, full control, real stealth, max token efficiency.

Install

npm install -g bladebro

Or use without installing:

npx bladebro mcp

DeepSeek Harness (DSH)

Add Bladebro as a native plugin in the Web UI's Plugins page, or run:

dsh plugin --profile web add bladebro

Restart the profile and start a new chat. Desktop users can install bladebro from the same Plugins page. For terminal setup, enable Desktop's Manage dsh Command, fully quit the app, then use its bundled command:

dsh plugin --profile desktop add bladebro

Use Desktop's command for its profile; the npm DSH CLI cannot manage that app-owned profile. Open Desktop again after installation.

DSH discovers the five tools as mcp__bladebro__act, see, state, run and vision (each with the same prefix). Schemas and descriptions come from the binary; DSH handles permissions, image attachments, reconnection and cleanup through its native MCP bridge. DSH may also expose its own generic MCP resource helpers and choose PTC presentation. No API key, separate MCP configuration, global Bladebro install or extra plugin package is needed. Chrome/Chromium must be installed on the machine running the DSH host. A remotely hosted Web UI controls that host's browser, rather than the device viewing the UI.

Disable/re-enable the Bladebro bundle in Plugins, or remove it with dsh plugin --profile web remove bladebro (use desktop with Desktop's command). Restart the profile and begin a new chat after package changes. Other tools and settings remain intact. Do not also configure a second MCP server named bladebro; DSH refuses the duplicate namespace.

Updates use DSH's package manager: dsh plugin --profile web update bladebro, or Update in Plugins. The plugin and native binary travel in the same package, so ordinary Bladebro releases update both. Existing global/Pi installs are separate. No background downloader or installation scripts run.

Advanced configuration belongs in the profile's cordis.patch.yml:

- id: bladebro
  config:
    # Optional absolute source-build/portable executable; package binary is default.
    binaryPath: /absolute/path/to/bladebro
    env:
      CHROME_PATH: /absolute/path/to/chrome
      BLADE_HOME: /absolute/path/to/private/browser-data
    toolCallTimeoutMs: 180000

Windows YAML paths can use forward slashes, such as C:/Tools/bladebro.exe. The optional cwd and reconnect settings use DSH's native MCP configuration. The default per-call budget is 180 seconds; raise it for longer run sequences. Cancellation stops waiting, but an already-dispatched browser mutation may finish: observe its destination before trying it again.

The npm CLI keeps its Node.js >=14 requirement; the DSH plugin uses the host's Node.js requirement. Prebuilt binaries cover Linux x64/ARM64 (glibc >=2.28), macOS Intel/Apple Silicon and Windows x64. Other targets need a source build and binaryPath. See the official DSH plugin commands and Desktop command runtime.

MCP and CLI

Option 1: MCP Server

For AI agents that speak MCP (Model Context Protocol). Point your agent at it:

{
  "mcpServers": {
    "bladebro": {
      "command": "bladebro",
      "args": ["mcp"]
    }
  }
}

Five tools: act, see, state, run, vision. Full docs at github.com/dondai44423/bladebro.

Option 2: CLI

For AI agents that run shell commands. One persistent Chrome instance across all commands (auto-daemon):

bladebro nav https://example.com     # auto-starts daemon + Chrome
bladebro see content                 # uses same Chrome
bladebro act click e5                # uses same Chrome
bladebro stop                        # cleans up

# JSON output for agents:
bladebro nav https://example.com --json
bladebro see content --json

# Agent discovery (returns tool schemas + CLI mapping):
bladebro help --json

Requirements

• Node.js >= 14
• Chrome/Chromium installed (Bladebro finds it automatically)
• Linux prebuilt binaries: glibc >= 2.28

Platforms

Prebuilt binaries available for:

• Linux x86_64 (linux-x64)
• Linux ARM64 (linux-arm64)
• macOS Apple Silicon (darwin-arm64)
• macOS Intel (darwin-x64)
• Windows x86_64 (windows-x64)

Other platforms: build from source.

License

Apache-2.0