macOS Control
| Metadata | Value |
|---|---|
| Category | macos |
| Capabilities | shell |
| Website | https://www.apple.com/macos/ |
Returns shapes
Section titled “Returns shapes”image— fromscreenshot_display,screenshot_window
Readme
Section titled “Readme”Read-only macOS inspection skill for local computer awareness. This first pass is intentionally limited to discovery and screenshots only.
What It Uses
Section titled “What It Uses”system_profilerfor installed apps and display metadatapsfor running processes- Swift with
AppKitandCoreGraphicsfor display and window geometry - JXA via
System Eventsfor window state like minimized, fullscreen, hidden, and focused screencapturefor window and display PNG captures
Permissions
Section titled “Permissions”For best results, grant:
- Accessibility access to the host process so
System Eventscan inspect windows - Screen Recording access so
screencapturecan capture window and display images
Without those permissions, list_windows and screenshot tools may return incomplete data or fail.
Tool Notes
Section titled “Tool Notes”list_apps
Section titled “list_apps”Returns installed applications from system_profiler SPApplicationsDataType -json.
run({ skill: "macos-control", tool: "list_apps", params: { limit: 10 } })list_processes
Section titled “list_processes”Returns stable process fields from ps, including pid, ppid, cpu_percent, memory_percent, and command.
run({ skill: "macos-control", tool: "list_processes", params: { limit: 25 } })list_displays
Section titled “list_displays”Returns display IDs, 1-based display indices for screenshot capture, geometry, scale, and relative position to the primary display.
run({ skill: "macos-control", tool: "list_displays" })list_windows
Section titled “list_windows”Returns useful user-facing windows only. Each result includes window_id when it could be matched to a CoreGraphics window and a capture_eligible flag for screenshot safety.
run({ skill: "macos-control", tool: "list_windows", params: { limit: 20 } })screenshot_window
Section titled “screenshot_window”Captures a PNG for a window_id returned by list_windows.
run({ skill: "macos-control", tool: "screenshot_window", params: { window_id: 12345 } })screenshot_display
Section titled “screenshot_display”Captures a PNG for a display. You can pass display_id, display_index, or neither to default to the primary display.
run({ skill: "macos-control", tool: "screenshot_display", params: { display_index: 1 } })This skill currently does not mutate app or window state. It does not open, focus, move, resize, quit, or force-quit anything in this first pass.