AppKit Window Control

Create and manage macOS AppKit windows with transparent overlays and event handling.

2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/tukuyomil032/Perch --skill appkit-window-control
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: AppKit Window Control
Source: https://github.com/tukuyomil032/Perch/tree/main/.agents/skills/appkit-window-control
Command: npx skills add https://github.com/tukuyomil032/Perch --skill appkit-window-control

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the complexity of creating and managing macOS AppKit windows, providing tools for transparent overlays, level management, and event handling to enhance dynamic UI design.

Core Features & Use Cases

  • Transparent Overlay Windows: Configure and manage transparent NSWindow/NSPanel overlays.
  • Window Level Management: Set window levels for various scenarios, including status bar integration.
  • Spaces and Fullscreen Support: Ensure seamless integration with Spaces and fullscreen modes.
  • Mouse Event Passthrough: Control event passing through windows based on their state (compact or expanded).
  • Integration with SwiftUI: Combine with SwiftUI for custom UI elements.
  • Use Case: Design a sophisticated application UI with transparent elements that dynamically change state and behavior based on user interactions and system events.

Quick Start

Initialize a transparent overlay window using IslandWindow and position it relative to the screen notch or floating for non-notch screens.

Frequently Asked Questions about AppKit Window Control

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

FAQPage Schema
How do I create a transparent overlay window in macOS using AppKit?

To create a transparent overlay window in macOS, configure an NSWindow or NSPanel with transparent backgrounds and appropriate window levels. The Skill guides initializing an IslandWindow and positioning it relative to the screen notch or floating for non-notch screens.

Can I control mouse event passthrough for non-interactive macOS windows?

Yes, you can control mouse event passthrough by configuring the window to ignore or accept mouse events based on its state. The Skill supports managing event passing dynamically, allowing clicks to pass through transparent windows when they are compact or expanded.

Does this approach support integrating AppKit windows with SwiftUI?

Yes, the approach supports integrating AppKit windows with SwiftUI. You can combine NSWindow and NSPanel management with SwiftUI to build custom UI elements, allowing for sophisticated application interfaces that dynamically change state and behavior based on user interactions.

What is the best way to manage AppKit window levels for status bar integration?

The best way to manage AppKit window levels for status bar integration is to explicitly set the window level property. This Skill provides guidance on configuring these levels to ensure your overlay interacts correctly with the system status bar and fullscreen applications.

Do I need to manage Spaces and fullscreen support when creating transparent macOS overlays?

Yes, you need to manage Spaces and fullscreen support to ensure seamless integration of transparent macOS overlays. The Skill provides guidance on configuring NSWindow and NSPanel behaviors so your dynamic UI elements function correctly across different desktop Spaces and fullscreen modes.