Claude For Safari

Claude for Safari

Give your AI Agent the power to control Safari

Website · Quick Start · Features · FAQ

English | 中文

---

Why This?

You want your AI Agent to help with browser tasks — then you discover:

• 🔒 Playwright → Separate browser instance, hijacks your session
• 🧩 Claude for Chrome → Requires Chrome extension, doesn't work with Safari
• 📝 Copy & paste → Manually feeding page content to AI every time

You just want AI to use your Safari, as if you were doing it yourself.

Claude for Safari makes it one command:

npx skills add SDLLL/claude-for-safari

After installing, tell Claude "check what's open in my Safari" — it reads and controls your real browser directly.

If this saves you time, give it a ⭐ — it helps other developers discover the project!

---

Quick Start

Run this in your terminal:

npx skills add SDLLL/claude-for-safari

Then launch Claude Code:

claude

Say "show me what tabs are open in Safari". The agent will guide you through permission setup automatically.

Compatible with any AI Agent that supports Skills: Claude Code, Cursor, Windsurf, etc.

First-Time Setup

The agent auto-detects and guides you, but you can configure ahead of time:

1. System Settings > Privacy & Security > Automation → Allow terminal to control Safari
2. Safari > Settings > Advanced → Enable "Show features for web developers"
3. Safari > Develop menu → Check "Allow JavaScript from Apple Events"
4. (Optional) System Settings > Privacy & Security > Screen Recording → Allow the terminal or agent host (enables reliable background screenshots)
5. (Optional) System Settings > Privacy & Security > Accessibility → Required only for System Events clicks and keystrokes

---

Features

No browser extension, proxy, or persistent daemon. The core uses macOS-native capabilities; optional window helpers require an available Swift toolchain.

Capability	What the Agent Does	How
List tabs	List all windows and tabs with title & URL	AppleScript
Read pages	Extract text, structured data, simplified DOM	AppleScript + JavaScript
Execute JS	Run arbitrary JavaScript in page context	AppleScript do JavaScript
Screenshot	Capture Safari window — AI can "see" the page	screencapture
Navigate	Open URLs, new tabs, new windows	AppleScript
Click	Click elements (React/Vue/Angular compatible)	JavaScript dispatchEvent
Type	Fill forms, simulate keyboard input	JavaScript + System Events
Safe form filling	Discover fields and fill supported non-sensitive controls with per-field verification	Bundled JavaScript + JXA
Network observation	Observe redacted page-level fetch/XHR metadata; bodies are explicit opt-in	Bundled JavaScript
Control indicator	Show when an agent is changing a page and clean up afterward	Bundled JavaScript
Scroll	Scroll up/down, scroll to element	JavaScript scrollBy/scrollTo
Switch tabs	Switch by index or URL keyword	AppleScript
Wait for load	Wait until page is fully loaded	JavaScript readyState

Screenshot Modes