@dokobot/cli

Connect your Chrome browser to AI agents. Free and privacy-first. Powered by Dokobot.

• Free forever. Local mode gives you unlimited reads with no API key, no account, no usage limits.
• Privacy-first. Local mode keeps all data on your machine. Remote mode supports end-to-end encryption so the server never sees your content in plaintext.
• Works with any AI agent. Claude Code, Codex, OpenClaw, Windsurf, or any tool that speaks MCP.

Install

npm i -g @dokobot/cli

Quick Start

Local mode (free, unlimited)

dokobot install-bridge    # Install native messaging bridge (one-time)
dokobot install-skill     # Install skill for your AI agent (one-time)
dokobot doko read --local https://example.com

Remote mode (cloud API)

dokobot config            # Configure your API key
dokobot install-skill     # Install skill for your AI agent (one-time)
dokobot doko read https://example.com
dokobot doko search "latest AI news"

Commands

install-bridge

Install the native messaging bridge for local mode. This connects your CLI directly to the Chrome extension without going through the server.

dokobot install-bridge              # Install
dokobot install-bridge --uninstall  # Remove

After installing, restart Chrome or reload the extension.

doko read <url>

Read a web page and output clean text.

# Local mode (free, unlimited, no API key needed)
dokobot doko read --local https://example.com

# Remote mode (via cloud API)
dokobot doko read https://example.com

# With options
dokobot doko read --local https://example.com --screens 3 --timeout 30
dokobot doko read https://example.com --device <id> --format chunks

| Option | Description | |--------|-------------| | --local | Use local bridge instead of remote server | | --device <id> | Target device ID | | --screens <n> | Number of screens to capture (default: auto) | | --timeout <seconds> | Read timeout in seconds (default: 60) | | --format <type> | Response format: text (default) or chunks | | --reuse-tab | Reuse existing tab instead of opening a new one | | --session-id <id> | Continue from a previous session |

When a page has more content to scroll, the output includes a session ID. Use --session-id to continue reading.

doko close-session <sessionId>

Close an active read session and release the browser tab.

dokobot doko close-session <sessionId>
dokobot doko close-session --local <sessionId>

| Option | Description | |--------|-------------| | --local | Close a local session | | --device <id> | Target device ID (local mode) |

doko search <query>

Search the web and return results.

dokobot doko search "dokobot mcp integration"
dokobot doko search "latest AI news" --num 10

| Option | Description | |--------|-------------| | --num <n> | Number of results, 1-10 (default: 5) |

install-skill

Download and install the Dokobot skill for your AI agent. Auto-detects installed agents or lets you choose.

dokobot install-skill                       # Interactive agent selection
dokobot install-skill --agent claude-code   # Install for Claude Code
dokobot install-skill --agent codex         # Install for Codex
dokobot install-skill -o ./my-skills        # Custom skills directory

Supported agents: claude-code (or claude), openclaw, windsurf, codex.

doko list / doko remove <id>

List or remove registered doko devices.

Other commands

dokobot config      # Configure API key, server URL, and encryption
dokobot update      # Check for updates

End-to-End Encryption

Remote reads support end-to-end encryption. When enabled, page content is encrypted on the server and only decrypted locally by your CLI.

dokobot config    # Set encryption password during setup

You can also set the password via the DOKO_ENCRYPTION_PASSWORD environment variable or the --password flag. The CLI uses scrypt key derivation with AES-256-GCM encryption.

If encryption is configured, remote doko read results are automatically encrypted and decrypted. The CLI will warn if the server returns unencrypted data when a key is configured, and fail fast if the encryption key doesn't match.

Global Options

| Option | Description | |--------|-------------| | --api-key <key> | API key (or set DOKO_API_KEY env) | | --password <password> | Encryption password (or set DOKO_ENCRYPTION_PASSWORD env) | | --server <url> | Server URL (default: https://dokobot.ai) | | --verbose | Enable verbose logging |

License

MIT