Drive Safari on macOS with AppleScript: reliable page waits, reading, forms, uploads, downloads with the page's session, screenshots. Works in a dedicated window with domain policy and sensitive-field guards.
An Agent Skill for driving Safari on macOS through AppleScript: navigation, reading, forms, uploads, downloads with the page's own session, screenshots.
It exists for the jobs a headless browser cannot do — sites where the user is already signed in — and it treats that access with care: its tool works in a dedicated window, refuses to type into password fields without explicit confirmation, can be confined to a list of domains, and never reads cookies or stored passwords.
| Path | Purpose |
|---|---|
SKILL.md | Safety rules, the working loop, what is easy to get wrong, limits |
references/how-it-works.md | Why each technique is needed (pending navigations, framework inputs, results, dialogs) |
references/applescript-recipes.md | The nine recipes with a typical sequence |
scripts/safari.mjs | Command-line tool, JSON output, state kept between invocations |
scripts/recipes/*.applescript | Standalone osascript programs |
scripts/lib/ | The engine (shared with the safari-mcp server) |
No dependencies beyond Node.js 20+ and macOS's own osascript, screencapture and sips.
skills install @spboucher/safari-applescript --client claude-code # or codex, cursor, generic-agent-skills
On Safari 27.0 / macOS 27.0: every recipe and the whole command-line flow run against a local fixture site (forms with framework-style inputs, shadow DOM, same-origin iframes, late content, dialogs, cookie-protected downloads, uploads), and the test asserts that the user's own windows are unchanged afterwards. Not tested on older Safari or macOS versions.
macOS and Safari only. Cross-origin iframes, private windows, Reader, in-tab PDFs and browser
settings are out of reach. Synthetic events are not real input. See SKILL.md.
Destination: ~/.claude/skills/safari-applescript · project scope: .claude/skills/safari-applescript
1Install with the Skills CLI (verifies the checksum, previews the destination, never runs scripts)
skills install @spboucher/safari-applescript@1.0.0 --client claude-codeAdd --project to install into .claude/skills/safari-applescript instead of ~/.claude/skills/safari-applescript.
2Or manually: download the release archive
curl -fsSLo safari-applescript-1.0.0.tar.gz https://skills.spboucher.ai/api/v1/artifacts/spboucher/safari-applescript/versions/1.0.0/download3Verify the SHA-256 checksum
echo "afac7dd71d90865e62dbfe6145799b1131084c71099c083977945945da8c2a2f safari-applescript-1.0.0.tar.gz" | shasum -a 256 -c -4Inspect the contents before extracting
tar -tzf safari-applescript-1.0.0.tar.gz5Extract into ~/.claude/skills/safari-applescript
mkdir -p ~/.claude/skills/safari-applescript && tar -xzf safari-applescript-1.0.0.tar.gz -C ~/.claude/skills/safari-applescriptInstalling only copies or configures. Nothing is executed for you. The Skills CLI verifies the checksum before writing files.
Select a file to preview it. Files are shown as plain text and never executed.
scripts/lib/osa.mjsscripts/lib/page.jsscripts/lib/safari.mjsscripts/recipes/click.applescriptscripts/recipes/fetch-base64.applescriptscripts/recipes/fill-field.applescriptStatic checks are advisory. They never certify that a package is safe. Compatibility entries are publisher claims unless marked verified.
| Version | Published | Size | SHA-256 | State |
|---|---|---|---|---|
| 1.0.0latest | Nov 10, 2026 | 29 kB | afac7dd71d90… | published |
Write, review, debug and migrate OpenAI API code with model tables and a request linter built from live probes of 29 models. Covers Responses, Chat Completions, tools, costs and tested scaffolds.
Write, review, debug and migrate Claude API code with model tables and a request linter built from live API probes of 15 models. Includes cost estimates and tested agent scaffolds.
Checks that every in-text citation in a Markdown or LaTeX manuscript has a bibliography entry, and the reverse.