@everbrowser/cli

Programmatic browser control from the terminal. Drive Chrome with simple commands or let an autonomous agent complete tasks for you.

Install

npm install -g @everbrowser/cli

Quick Start

ever start --url https://example.com   # Open a browser session
ever snapshot                           # Capture DOM with element [id] annotations
ever click 3                            # Click element [3]
ever input 5 "hello world"             # Type into element [5]
ever screenshot                         # Save a viewport screenshot
ever run "find the best flight to NYC"  # Run an autonomous agent task

Commands

Session Management

| Command | Description | |---------|-------------| | ever start [--url <url>] | Create a new browser session | | ever sessions | List active sessions | | ever use <index> | Switch active session | | ever stop [--session] [--all] | Stop task, session, or all sessions | | ever tabs | List tabs in active session |

Browser Actions

Use ever snapshot first to get element [id] annotations, then reference them in actions.

| Command | Description | |---------|-------------| | ever snapshot | Capture DOM with [id] annotations on interactive elements | | ever click <id> | Click an element by snapshot index | | ever input <id> <text> | Type text into an input element (--clear to replace) | | ever navigate <url> | Navigate to a URL (--new-tab for new tab) | | ever scroll <up\|down> | Scroll page or element (--amount, --id) | | ever send-keys <keys> | Send keyboard keys or shortcuts (e.g. Control+c) | | ever switch-tab <tabId> | Switch to a different tab | | ever close-tab <tabId> | Close a tab | | ever search <query> | Search the web (--engine google\|bing\|duckduckgo\|brave) | | ever screenshot | Capture viewport screenshot | | ever extract | Extract page content as readable markdown | | ever eval <expression> | Execute JavaScript in the page context | | ever wait <seconds> | Wait for a specified duration |

Form Actions

| Command | Description | |---------|-------------| | ever select-dropdown <id> <text> | Select an option in a <select> dropdown | | ever get-dropdown-options <id> | List options in a <select> dropdown | | ever upload-file <id> <files...> | Upload files to a file input |

Agent

| Command | Description | |---------|-------------| | ever run <task> | Run an autonomous agent task | | ever status | Show running agent tasks | | ever logs [--follow] | Stream agent logs |

Utilities

| Command | Description | |---------|-------------| | ever doctor | Check connectivity (daemon, API, extension) | | ever version | Show version info | | ever login | Store API key | | ever logout | Remove API key | | ever mcp | Start MCP stdio server for coding agents | | ever debug-bundle | Collect diagnostics for debugging | | ever daemon stop | Stop the background daemon | | ever daemon status | Check daemon status |

Domain-Specific

| Command | Description | |---------|-------------| | ever sheets select-cell <cell> | Navigate to a cell in Google Sheets | | ever fs write <file> <content> | Write content to a file | | ever fs read <file> | Read file content | | ever fs replace <file> <old> <new> | Find and replace in a file |

MCP Integration

Use Ever as an MCP server so coding agents (Claude Code, Cursor, etc.) can control the browser:

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

Architecture

The CLI communicates with a local daemon (everd) that manages browser sessions via the Chrome extension. The daemon auto-starts on first use.

ever CLI  →  everd (local daemon)  →  Chrome Extension (CDP)  →  Browser