菜单
Run subprocesses from JXA/osascript using NSTask. Use when you need separate stdout/stderr streams, async execution, stdin piping, kill signals, exit codes, or running uv Python scripts from within a JXA automation script.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | osascript-subprocess |
| description | Run subprocesses from JXA/osascript using NSTask. Use when you need separate stdout/stderr streams, async execution, stdin piping, kill signals, exit codes, or running uv Python scripts from within a JXA automation script. |
NSTask via JXA ObjC bridge — full POSIX process control from within osascript. All scripts are Python with JXA embedded as strings.
doShellScript | NSTask | |
|---|---|---|
| Execution | Synchronous, blocks | Sync or async |
| stderr | Merged or lost | Separate NSPipe |
| stdin | None | NSPipe — writable |
| Kill process | Cannot | task.terminate() |
| Exit code | Only via error | task.terminationStatus |
| Long-running | Blocks script | Background option |
Use doShellScript for quick one-liners. Use NSTask when you need stderr, stdin, kill, or async.
uv lives in /opt/homebrew/bin. Always set PATH explicitly in NSTask — it does not inherit shell PATH:
task.environment = $.NSDictionary.dictionaryWithObjectsAndKeys(
$("/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"), $("PATH"),
...
);
Use /usr/bin/env as launchPath with ["uv", "run", ...] as arguments — lets env resolve uv from PATH.
Run any shell command via NSTask — returns {stdout, stderr, exitCode}:
uv run scripts/run-command.py "ls -la /tmp"
uv run scripts/run-command.py "ping -c 3 google.com"
Run a uv run Python script via NSTask with proper PATH resolution:
uv run scripts/run-uv-script.py /path/to/script.py arg1 arg2
Script macOS apps via AppleScript/JXA: Mail, Calendar (EventKit attendees), Notes, Reminders, Finder (disk/file info), and Spotlight/mdfind (full-text and metadata search across the file system).
Control macOS system audio via osascript. Use when getting or setting system volume, toggling mute, listing audio input/output devices, or checking which device is the default output.
Automate Google Chrome with osascript/JXA. Use when listing/focusing/closing/navigating/reloading tabs, muting tabs, managing windows, executing JavaScript, scraping page content, extracting links, filling forms, reading localStorage/cookies/audio state, or reading Chrome history/bookmarks/downloads/extensions/profiles.
Read and write the macOS clipboard with full type support. Use when reading clipboard text, HTML, RTF, images, or file paths (Finder copy); writing rich content; detecting clipboard changes via changeCount; or intercepting content between copy and paste.
Read macOS app SQLite databases directly. Use when reading iMessage chat history, Chrome browsing history, Safari history, or any local app SQLite DB. Always copy the DB before querying — most apps lock the file while running.
Create and manage macOS LaunchAgents and LaunchDaemons. Use when setting up background automation, scheduled tasks, file watchers (WatchPaths), interval polling, or persistent daemons that survive logout or reboot.