skill-body

ego-browser

Call help() or help("page.click") to print signatures and uncommon options of APIs named below; it prints by itself, so do not wrap it in console.log. For installation or connection problems, read references/install.md in the ego-browser Skill directory.

Run browser scripts

Pass the script to ego-browser nodejs. The form depends on the shell that runs the command: heredoc is Bash/Zsh syntax and does not exist in PowerShell or cmd.

Bash, Zsh, Git Bash

ego-browser nodejs <<'EOF'
const task = await taskSpace("inspect example page");
const page = task.page("p1");
await page.goto("https://example.com");

console.log({ taskSpaceId: task.spaceId, page: page.label });
console.log(await page.snapshot());
EOF

When a sandbox blocks heredoc input, use -e instead. Use single quotes around the code and double quotes for JavaScript strings; single quotes within the code require shell quoting.

ego-browser nodejs -e '
const task = await taskSpace("inspect example page");
await task.page("p1").goto("https://example.com");
console.log(task.spaceId);
'

PowerShell

PowerShell has no heredoc, and Windows PowerShell 5.1 drops the double quotes inside an argument when it calls a native program, which splits the script into several arguments. Do not pass a script that contains double quotes or spans several lines to -e. Write it to a UTF-8 .mjs file instead and evaluate an ASCII-only one-line entry point, which needs no double quotes of its own:

ego-browser nodejs -e "await import('file:///C:/Users/<name>/ego/task.mjs')"

The imported module runs with the same helpers and console as an inline script, so the whole task belongs in the .mjs file. Use forward slashes in the file:/// URL. Non-ASCII content such as Chinese text must stay inside the file: never put it in a -e argument.

Do not pipe the file in with Get-Content. Windows PowerShell 5.1 reads a UTF-8 file as ANSI and sends ASCII to native programs, which corrupts non-ASCII text and truncates strings. PowerShell has no < input redirection either.