mcpField
M
macos

macos

github.com/fusengineDevelopment3447 installsUpdated 2w ago
Repository

About macos

A skill covering macOS app development, including window management, menu bar utilities, AppKit integration, and distribution preparation. It is for developers building Mac applications and includes XcodeBuildMCP build and test workflows.

Key features

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

Use cases

  1. 01Build a macOS menu bar utility
  2. 02Structure an app with multiple windows and settings
  3. 03Embed AppKit views in SwiftUI
  4. 04Prepare a Mac app for distribution

MCP support

Includes XcodeBuildMCP tools for building, running, testing, launching, and stopping macOS apps.

Install

Copy the command and run it in a terminal.

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

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

Bundled files

References and scripts installed along with SKILL.md.

references/
app-structure.md
appkit-integration.md
build-tools.md
notarization.md

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