Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@dokobot/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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, Cursor, Codex, Hermes Agent, OpenClaw, Windsurf, or any tool that speaks MCP.

Install

npm i -g @dokobot/cli

Prerequisites

Install the Dokobot Chrome extension first. The CLI connects to your browser through this extension.

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`	Connect directly to your local browser
`--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
`-o, --output <file>`	Write output to a file instead of stdout

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

# Save output to a file
dokobot doko read --local https://example.com -o page.md

`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`	Connect directly to your local browser
`--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), cursor, codex, hermes (or hermes-agent), openclaw, windsurf.

`doko list`

List available devices, including local bridges and remote dokos.

dokobot doko list

Shows local bridges (connected via native messaging) and remote dokos (connected via cloud API) with their online/offline status.

`config`

View or edit CLI configuration.

dokobot config show   # Show current configuration
dokobot config        # Edit configuration interactively

`update`

Check for CLI updates.

dokobot update

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