list-windows

List open macOS windows with app names, titles, and window IDs.

1|Updated Feb 9, 2026

Search Tags:#automation #cli #bash #macos #list #screenshot #windows

Ready to run

npx skills add https://github.com/brennacodes/brenna-plugs --skill list-windows

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: list-windows
Source: https://github.com/brennacodes/brenna-plugs/tree/main/plugins/screenshotr/skills/list-windows
Command: npx skills add https://github.com/brennacodes/brenna-plugs --skill list-windows

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

List open windows on macOS with app names, titles, and window IDs to help identify targets for screenshot capture.

Core Features & Use Cases

Display app name, window title, and window ID for each on-screen window.
Filter out hidden windows and sort results by app name to speed up target selection.
Integrate with /screenshotr:capture to streamline targeted captures.

Quick Start

Identify the target window and issue the capture command with /screenshotr:capture window 'AppName'.

Frequently Asked Questions about list-windows

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I list open windows on macOS to identify targets for screenshots?▼

To list open windows on macOS, this Skill invokes a local bash script that parses window metadata and outputs a table of app names, window titles, and window IDs. It filters out hidden windows and sorts results by app name for quick target identification.

What macOS window details are displayed when listing available screenshot targets?▼

Listing available screenshot targets displays the app name, window title, and window ID for each on-screen window. The script filters out hidden windows and sorts the output by app name to streamline the target selection process.

Do I need a Bash environment to run the list-windows script on macOS?▼

Yes, you need a Bash environment to run the list-windows script on macOS. The Skill requires the scripts/list-windows.sh file to parse window metadata and produce the APP_NAME, WINDOW_TITLE, WINDOW_ID, and ON_SCREEN output.

How do I capture a specific macOS window after finding its window ID?▼

After finding the target window ID, you can issue the capture command using /screenshotr:capture window followed by the 'AppName'. This integrates window listing directly with targeted screenshot capture to streamline the workflow.

Does the list-windows output include hidden background windows on macOS?▼

No, the list-windows output does not include hidden background windows. The script filters results to only display on-screen windows, ensuring you only see active app names, titles, and IDs when selecting screenshot targets.