mcpField
M
macos

macos

github.com/fusengineDevelopment3447 installsUpdated 3d ago
Repository

About macos

macos is a development skill for building macOS apps, covering SwiftUI window and menu-bar patterns, AppKit integration, and distribution preparation. It also lists XcodeBuildMCP tools for building, launching, and testing macOS apps.

Key features

  1. 01MenuBarExtra utility app patterns
  2. 02Multi-window and Settings scenes
  3. 03Keyboard shortcuts and menus
  4. 04AppKit integration with SwiftUI
  5. 05Notarization and sandboxing guidance
  6. 06XcodeBuildMCP build and test tools

Use cases

  1. 01Building a menu bar utility
  2. 02Managing multiple app windows
  3. 03Embedding AppKit views in SwiftUI
  4. 04Preparing apps for external distribution

MCP support

The skill lists XcodeBuildMCP tools for building, running, testing, launching, and stopping macOS apps. These tools support the development workflow described by the skill.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fusengine/claude-plugins --skill macos

After installing, type/macosin Claude Code to confirm it loaded.

Details

From the project README
Covers macOS-specific development: menu bar apps via MenuBarExtra, multi-window application management, keyboard shortcuts and menus, AppKit integration (NSViewRepresentable) inside SwiftUI, and notarization for distribution outside the Mac App Store.

Lists the XcodeBuildMCP tools for macOS builds (build_macos, build_run_macos, test_macos, launch_mac_app, stop_mac_app) and references for app structure (MenuBarExtra, Settings, Windows), build tooling, AppKit bridging, and code-signing/notarization.

Best practices: support keyboard shortcuts for power users, use MenuBarExtra for utility apps, use WindowGroup/Window for multi-window apps and Settings for the preferences scene, notarize before distributing outside the App Store, and enable sandboxing for App Store submissions.

macOS Platform

macOS-specific development with window management and distribution tools.

Agent Workflow (MANDATORY)

Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:

  1. fuse-ai-pilot:explore-codebase - Analyze existing macOS patterns
  2. fuse-ai-pilot:research-expert - Verify latest macOS 27 docs via Context7/Exa
  3. mcp__XcodeBuildMCP__build_macos - Build for macOS validation

After implementation, run fuse-ai-pilot:sniper for validation.

Overview

When to Use
  • Building Mac desktop applications
  • Creating menu bar apps (MenuBarExtra)
  • Multi-window applications
  • Keyboard shortcuts and menus
  • Notarization for distribution
  • AppKit integration
Why macOS Skill
FeatureBenefit
MenuBarExtraBackground utility apps
Window managementMulti-window support
Keyboard shortcutsPower user productivity
NotarizationGatekeeper-safe distribution

MCP Tools Available

Build Tools
  • build_macos - Build for macOS
  • build_run_macos - Build and launch
  • test_macos - Run macOS tests
  • launch_mac_app - Start built app
  • stop_mac_app - Terminate app

Reference Guide

NeedReference
MenuBarExtra, Settings, Windowsapp-structure.md
XcodeBuildMCP macOS toolsbuild-tools.md
NSViewRepresentable, menusappkit-integration.md
Code signing, notarizationnotarization.md

Best Practices

  1. Keyboard shortcuts - Support power users
  2. Menu bar integration - For utility apps
  3. Multiple windows - Use WindowGroup/Window
  4. Settings window - Use Settings scene
  5. Notarization - Required for distribution
  6. Sandbox - Enable for App Store

Comments

Markdown supported