ego-browser

# ego-browser ego-browser gives AI agents a CLI-accessible Node.js runtime, with built-in helpers — snapshotText, click, js, cdp, and more — that agents call directly inside JS scripts to observe pages, interact with UI, evaluate browser-side JavaScript, and drive a real browser for any web automation task. For setup, install, or connection problems, read `references/install.md`. Use the `Bash` tool to run all browser operations via `ego-browser nodejs <<'EOF' ... EOF` heredoc. Do not write code to a `.js` file first. ## Quick start ```bash ego-browser nodejs <<'EOF' // Name the task space for the whole user task, then reuse that space across heredoc rounds. const task = await useOrCreateTaskSpace('inspect example page') cliLog('task space id: ' + task.id) await openOrReuseTab('https://example.com', { wait: true, timeout: 20 }) cliLog(await snapshotText()) EOF ``` The heredoc body runs as a Node.js script that controls the selected ego-browser task space. All ego-browser helpers are preloaded into that script. ## Common helpers - Task spaces: `listTaskSpaces`, `useOrCreateTaskSpace`, `claimTaskSpace`, `handOffTaskSpace`, `takeOverTaskSpace`, `waitForAgentControl`, `completeTaskSpace` - Navigation / state: `listTabs`, `openOrReuseTab`, `closeTab`, `gotoAndWait`, `currentTab`, `switchTab`, `gotoUrl`, `pageInfo`, `ensureRealTab` - Observation: `snapshotText`, `captureScreenshot`, `drainEvents` - Scroll / mouse: `scrollBy`, `scrollToBottomUntil`, `scroll`, `click`, `do...