bladebro

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

Packages

Package details

extension

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

$ pi install npm:bladebro
Package
bladebro
Version
3.9.3
Published
Aug 26, 2026
Downloads
6,356/mo · 346/wk
Author
dondai1234
License
Apache-2.0
Types
extension
Size
31.7 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "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

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

Two ways to use Bladebro

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)

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