Can this skill capture windows on different macOS Spaces?

Yes, it uses ScreenCaptureKit on macOS 12.3+ to capture windows regardless of which Space they are on, and can switch Spaces automatically when activating an application.

How do I find a JetBrains sandbox IDE using this tool?

Since sandbox IDEs often appear as 'Main', you can use the --args-contains filter to look for 'idea.plugin.in.sandbox.mode' to specifically target development instances.

Can I use the output in other scripts?

Absolutely. By using the --json flag, the skill returns structured data including window IDs, bounds, and artifact paths for easy integration into larger automation workflows.

Does it require special system permissions?

Yes, it requires Screen Recording permissions to access window titles and content, as well as Accessibility permissions to perform window activation and switching.

macOS Window Controller

Name: macOS Window Controller
Author: smykla-skalski

bysmykla-skalski

0•

生产力与工作流

Automates macOS window management by finding, activating, and capturing screenshots across multiple Spaces and displays.

This skill empowers developers to programmatically interact with macOS windows, providing advanced filtering capabilities by application name, regex window titles, and process arguments. It is specifically optimized for complex workflows, such as distinguishing between production and sandbox JetBrains IDE instances. By utilizing modern APIs like ScreenCaptureKit, it can capture screenshots of windows even when they are occluded or located on inactive Spaces, making it an essential tool for automated documentation, UI testing, and workspace organization.

主要功能

01Specialized detection logic for JetBrains sandbox/plugin development environments.

02Structured JSON output for integration with complex automation scripts and CLI pipes.

03Cross-Space window detection and activation using AppleScript and Quartz APIs.

04Advanced filtering by process path, PID, and command-line arguments.

050 GitHub stars

06High-resolution window-specific screenshots via ScreenCaptureKit (macOS 12.3+).

使用场景

01Automating the generation of UI screenshots for technical documentation and user guides.

02Quickly switching between multiple instances of the same IDE based on project context.

03Verifying application state in headless or automated testing environments on macOS.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add smykla-skalski/research window-controller

For use in Claude.ai and ChatGPT

主要功能

01Specialized detection logic for JetBrains sandbox/plugin development environments.

02Structured JSON output for integration with complex automation scripts and CLI pipes.

03Cross-Space window detection and activation using AppleScript and Quartz APIs.

04Advanced filtering by process path, PID, and command-line arguments.

050 GitHub stars

06High-resolution window-specific screenshots via ScreenCaptureKit (macOS 12.3+).

使用场景

01Automating the generation of UI screenshots for technical documentation and user guides.

02Quickly switching between multiple instances of the same IDE based on project context.

03Verifying application state in headless or automated testing environments on macOS.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add smykla-skalski/research window-controller

For use in Claude.ai and ChatGPT