// Send branded macOS notifications with custom app icon using terminal-notifier. Use when implementing native Notification Center integration with custom branding.
Show native macOS UI from scripts and agents — dialogs, forms, visualizations, floating widgets, cursor companions. Use when you need to display HTML to the user, collect input, show a chart, render markdown, or create any visual interaction without a browser.
Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.
Use this skill when planning, auditing, or refining the assistant UX in the native macOS client, especially setup, settings, chat trust surfaces, prompt wrappers, and command transparency.
Use this skill when planning, auditing, or implementing Metal-backed macOS desktop surfaces, especially hybrid SwiftUI/AppKit plus MetalKit apps, shader packaging, MTKView integration, and Metal toolchain setup.
| name | macos-branded-notifications |
| description | Send branded macOS notifications with custom app icon using terminal-notifier. Use when implementing native Notification Center integration with custom branding. |
Send native macOS notifications that display your app's custom icon instead of a generic Terminal icon.
YourApp.app/
├── Contents/
│ ├── Info.plist # App bundle metadata
│ └── Resources/
│ ├── AppIcon.icns # Your app icon (required)
│ ├── success.png # Optional content images
│ └── failure.png
mkdir -p YourApp.app/Contents/{MacOS,Resources}
Key fields:
CFBundleIdentifier: Unique reverse-domain identifier (used with -sender flag)CFBundleIconFile: Name of .icns file (without extension)LSUIElement: true hides app from Dock (background app)# From a 512x512 or 1024x1024 PNG source
mkdir -p AppIcon.iconset
sips -z 16 16 icon.png --out AppIcon.iconset/icon_16x16.png
sips -z 32 32 icon.png --out AppIcon.iconset/icon_16x16@2x.png
# ... all sizes up to 512x512@2x
iconutil -c icns AppIcon.iconset -o YourApp.app/Contents/Resources/AppIcon.icns
rm -rf AppIcon.iconset
/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -f /path/to/YourApp.app
brew install terminal-notifier
terminal-notifier \
-title "Your Title" \
-message "Your message" \
-sender com.yourcompany.yourapp \
-sound default
lsregister -f, then killall NotificationCentersudo rm -rf /Library/Caches/com.apple.iconservices.store && killall Finderfile:// URL format with -contentImage flag