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.
Installing 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.