bladebro

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

Packages

Package details

extensionskill

Install bladebro from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:bladebro
Package
bladebro
Version
4.6.10
Published
Nov 19, 2026
Downloads
3,084/mo · 658/wk
Author
dondai1234
License
Apache-2.0
Types
extension, skill
Size
23.8 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ],
  "extensions": [
    "./pi-extension.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Bladebro

Drive a real Chromium-family browser from your AI agent or terminal. Five MCP tools (act, see, state, run, vision) in one Rust binary — persistent Live Page Model, delta-first token efficiency, and real stealth.

Full documentation: github.com/dondai44423/bladebro

Install

npm install -g bladebro
bladebro doctor

MCP Server

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

Or without a global install: "command": "npx", "args": ["-y", "bladebro", "mcp"].

CLI

The first command auto-starts a local daemon and reuses the same browser across calls:

bladebro nav https://example.com
bladebro see content
bladebro act click e5
bladebro stop

bladebro see content --json    # single-object JSON output
bladebro help --json           # full tool schemas + CLI usage

Agent Integrations

  • Pi: pi install npm:bladebro (registers five native browser.* tools).
  • Hermes: bladebro hermes on (registers MCP and suppresses only Hermes' built-in browser toolset; status / off to inspect or restore).
  • DeepSeek Harness (DSH): install via the Web/Desktop Plugins page or dsh plugin --profile web add bladebro (for Desktop CLI, enable Manage dsh Command, quit Desktop, and use its bundled dsh plugin --profile desktop add bladebro). Tools appear under mcp__bladebro__*. Optional cordis.patch.yml overrides (binaryPath, env.CHROME_PATH, env.BLADE_HOME, toolCallTimeoutMs: default 180000) are documented in the Setup guide.

Requirements & Platforms

  • Node.js ≥ 14 (for the npm launcher; standalone binary has zero Node dependency)
  • Chrome, Chromium, Brave, Helium, Edge, Vivaldi, or Opera installed on the host
  • Prebuilt binaries via optionalDependencies (zero install scripts): linux-x64 and linux-arm64 (glibc ≥ 2.28; build from source on Alpine/musl), darwin-arm64, darwin-x64, windows-x64

License

Apache-2.0