control-safari

Control Safari

Use only the bundled script runtime. Do not look for or call MCP tools from this Skill. Every command returns JSON on stdout and is synchronous from the agent's perspective.

Start

Start one isolated session and keep its sessionId for every later command:

node {baseDir}/scripts/safari-repl.mjs start

Check Safari, then read and follow the complete operating guide:

node {baseDir}/scripts/safari-repl.mjs doctor --session SESSION_ID
node {baseDir}/scripts/safari-repl.mjs documentation --session SESSION_ID

Stop if the doctor reports that Safari 26 automation or JavaScript from Apple Events is unavailable.

Run

Run short cells directly:

node {baseDir}/scripts/safari-repl.mjs run \
  --session SESSION_ID \
  --title "Inspect the task tab" \
  --code 'var tabs = browser.tabs.list(); tabs'

For multiline or quote-heavy JavaScript, write it to a temporary file and use --code-file:

node {baseDir}/scripts/safari-repl.mjs run \
  --session SESSION_ID \
  --title "Operate the page" \
  --code-file /absolute/path/to/cell.js

Bindings declared with var persist within the same session. Never reuse a sessionId from another task. Image-producing cells return local paths in the images array; inspect those files with the current agent's image-reading tool.

Use a new task-owned Safari tab by default. Use separate task-owned tabs for different websites, and reuse a user tab only when the user explicitly requests it. Follow all confirmation and safety rules returned by documentation.

Read these references only when applicable:

• CAPTCHA or human verification: references/captcha.md
• Google account choice: references/google-accounts.md
• Google Docs: references/google-docs.md
• Google Sheets: references/google-sheets.md

Reset and cleanup

Reset bindings only when a clean REPL is required:

node {baseDir}/scripts/safari-repl.mjs reset --session SESSION_ID

Before every final response, including failures, release the control indicator and stop the session:

node {baseDir}/scripts/safari-repl.mjs release --session SESSION_ID
node {baseDir}/scripts/safari-repl.mjs stop --session SESSION_ID

Do not leave the background session running and do not mix this script transport with an MCP transport in the same browser task.