skills.rest
brennacodes
brennacodesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/brennacodes/brenna-plugs --skill list-windows
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
julianobarbosajulianobarbosa
7

Iterm2

Manage iTerm2 and tmux workflows with native -CC integration.

Community
Intermediate
drewipsondrewipson
24

Cross-Platform File Operations

Handle cross-platform file operations across macOS, Windows, and Linux.

Community
Advanced
LangQi99LangQi99
15

capture-screen-macos

Capture fullscreen and targeted window screenshots on macOS via Python and Swift.

Community
Intermediate
autonomy-cloudautonomy-cloud
2

macos-automation

Automate native macOS app interactions using AppleScript via osascript.

Official
Intermediate