How do I install the Osascript System skill?

Run npx skillmds@latest add damionrashford/osascript-system in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Osascript System safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Osascript System?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Osascript System free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Osascript System?

damionrashford (@damionrashford) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Osascript System by damionrashford — Agent Skill

Name: Osascript System
Author: damionrashford

Osascript System

Inspect macOS system state with osascript/JXA. Use when listing running apps, enumerating windows with positions and IDs, taking targeted screenshots by window, querying display geometry, or using the ObjC bridge (NSWorkspace, CGWindow, NSFileManager).

damionrashford b402c03 7 files · 11.2 KB Updated Sep 17, 2026

File contents

osascript-system

System state inspection via JXA + ObjC bridge. All scripts are Python with JXA embedded.

Critical Rule

Every ObjC call returns a wrapped object. Always ObjC.unwrap() before using in JS. This is the #1 error source.

Scripts

List all running apps via NSWorkspace (includes background daemons):

uv run scripts/list-apps.py

List all on-screen windows with bounds, layer, and CGWindow ID:

uv run scripts/list-windows.py

Screenshot a named app's window by CGWindow ID (no region math needed):

uv run scripts/screenshot-window.py "Safari"
uv run scripts/screenshot-window.py "Finder" /tmp/finder.png

Get the frontmost app: name, bundle ID, PID, and window title:

uv run scripts/get-focused-app.py

List all displays with frame, visible frame, and backing scale factor (Retina):

uv run scripts/get-displays.py

Screenshot a specific x,y,width,height pixel region of the screen:

uv run scripts/region-screenshot.py 0 0 1920 1080
uv run scripts/region-screenshot.py 100 100 800 600 /tmp/region.png

Key APIs

Need	API
All running apps + PIDs	`NSWorkspace.sharedWorkspace.runningApplications`
All windows + positions + IDs	`CGWindowListCopyWindowInfo`
Screenshot specific window	CGWindow ID + `screencapture -l`
Currently focused app + window title	`NSWorkspace.frontmostApplication` + System Events
Display geometry, Retina scale	`NSScreen.screens`
Region screenshot by coordinates	`screencapture -R x,y,w,h`

Reference

reference/03-jxa-objc-bridge.md — NSFileManager, NSWorkspace, ObjC.unwrap() rule
reference/04-system-capabilities.md — Shell bridge, clipboard, screen capture, polling
reference/05-system-events.md — Process list, window inspection, UI tree, focus, login items
reference/18-coregraphics-cgwindow.md — CGWindowListCopyWindowInfo, window IDs, z-order, display geometry

Permission Required

Screenshots require kTCCServiceScreenCapture. UI control via System Events requires kTCCServiceAccessibility.

---name: osascript-systemdescription: Inspect macOS system state with osascript/JXA. Use when listing running apps, enumerating windows with positions and IDs, taking targeted screenshots by window, querying display geometry, or using the ObjC bridge (NSWorkspace, CGWindow, NSFileManager).---# osascript-systemSystem state inspection via JXA + ObjC bridge. All scripts are Python with JXA embedded.## Critical RuleEvery ObjC call returns a wrapped object. Always `ObjC.unwrap()` before using in JS. This is the #1 error source.## ScriptsList all running apps via NSWorkspace (includes background daemons):```bashuv run scripts/list-apps.py```List all on-screen windows with bounds, layer, and CGWindow ID:```bashuv run scripts/list-windows.py```Screenshot a named app's window by CGWindow ID (no region math needed):```bashuv run scripts/screenshot-window.py "Safari"uv run scripts/screenshot-window.py "Finder" /tmp/finder.png```Get the frontmost app: name, bundle ID, PID, and window title:```bashuv run scripts/get-focused-app.py```List all displays with frame, visible frame, and backing scale factor (Retina):```bashuv run scripts/get-displays.py```Screenshot a specific x,y,width,height pixel region of the screen:```bashuv run scripts/region-screenshot.py 0 0 1920 1080uv run scripts/region-screenshot.py 100 100 800 600 /tmp/region.png```## Key APIs| Need | API ||------|-----|| All running apps + PIDs | `NSWorkspace.sharedWorkspace.runningApplications` || All windows + positions + IDs | `CGWindowListCopyWindowInfo` || Screenshot specific window | CGWindow ID + `screencapture -l` || Currently focused app + window title | `NSWorkspace.frontmostApplication` + System Events || Display geometry, Retina scale | `NSScreen.screens` || Region screenshot by coordinates | `screencapture -R x,y,w,h` |## Reference- [reference/03-jxa-objc-bridge.md](reference/03-jxa-objc-bridge.md) — NSFileManager, NSWorkspace, ObjC.unwrap() rule- [reference/04-system-capabilities.md](reference/04-system-capabilities.md) — Shell bridge, clipboard, screen capture, polling- [reference/05-system-events.md](reference/05-system-events.md) — Process list, window inspection, UI tree, focus, login items- [reference/18-coregraphics-cgwindow.md](reference/18-coregraphics-cgwindow.md) — CGWindowListCopyWindowInfo, window IDs, z-order, display geometry## Permission RequiredScreenshots require `kTCCServiceScreenCapture`. UI control via System Events requires `kTCCServiceAccessibility`.

Frequently asked questions