bladebro
Stealthy and efficient agentic browser driver for AI agents. Few tools, full control, real stealth, max token efficiency.
Package details
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 nativebrowser.*tools). - Hermes:
bladebro hermes on(registers MCP and suppresses only Hermes' built-in browser toolset;status/offto 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 bundleddsh plugin --profile desktop add bladebro). Tools appear undermcp__bladebro__*. Optionalcordis.patch.ymloverrides (binaryPath,env.CHROME_PATH,env.BLADE_HOME,toolCallTimeoutMs: default180000) 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-x64andlinux-arm64(glibc ≥ 2.28; build from source on Alpine/musl),darwin-arm64,darwin-x64,windows-x64
License
Apache-2.0