mcpField
A
axiom-macos

axiom-macos

github.com/charleswiltgenDevelopment1.2k1.4k installsUpdated today
Repository

About axiom-macos

An Axiom skill for macOS development, with task-oriented references for windows, menus, sandboxing, distribution, and AppKit interoperability. It helps distinguish macOS-specific concerns from shared SwiftUI topics.

Key features

  1. 01Window and scene management guidance
  2. 02Menus, commands, and shortcut references
  3. 03macOS SwiftUI differences
  4. 04Sandbox and file access guidance
  5. 05AppKit interoperability references
  6. 06Screen capture and recording guidance

Use cases

  1. 01Implement macOS window and menu behavior
  2. 02Diagnose sandbox file access issues
  3. 03Bridge AppKit and SwiftUI
  4. 04Set up screen capture or recording

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/charleswiltgen/axiom --skill axiom-macos

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

Bundled files

References and scripts installed along with SKILL.md.

skills/
appkit-interop.md
appkit-modernization.md
direct-distribution.md
ios-apps-on-mac.md
menus-and-commands.md
sandbox-and-file-access.md
screencapturekit-ref.md
screencapturekit.md
settings.md
swiftui-differences.md
windows.md

Details

From the project README

macOS Development

You MUST use this skill for ANY macOS-specific development including windows, menus, sandboxing, distribution, AppKit bridging, and macOS SwiftUI differences.

Quick Reference

Symptom / TaskReference
Window management (WindowGroup, Window, MenuBarExtra, DocumentGroup)See skills/windows.md
Menu bar, commands, keyboard shortcutsSee skills/menus-and-commands.md
Table, Inspector, NavigationSplitView, focusSee skills/swiftui-differences.md
App Sandbox, file access, security-scoped bookmarksSee skills/sandbox-and-file-access.md
Another team's app or app group container access denied without a prompt (OS27)See skills/sandbox-and-file-access.md
Developer ID, notarization, Sparkle auto-updatesSee skills/direct-distribution.md
NSViewRepresentable, NSHostingController, AppKit bridging, @Observable in AppKit, NSHostingMenu, SwiftUI scenes from AppKitSee skills/appkit-interop.md
Modernizing AppKit: mouseDown replacement, control events, status-item sessions, state restoration, concentric corners, touch (OS27)See skills/appkit-modernization.md
Screen recording, sharing, or capture (ScreenCaptureKit)See skills/screencapturekit.md
SCStream / SCContentFilter / screenshots / file recording API, clip buffering, recording editor (OS27)See skills/screencapturekit-ref.md
Bring an iOS app to Mac: Catalyst adoption, Designed for iPad, Mac availability opt-outSee skills/ios-apps-on-mac.md
Apple Pay on Mac / CatalystSee axiom-payments/skills/apple-pay.md (Catalyst section)

Cross-Suite Routes

These topics overlap with macOS development but live in separate suites:

SwiftUI (shared iOS/macOS)
  • View state, data flow, @Observable → See axiom-swiftui
  • Navigation (NavigationStack basics) → See axiom-swiftui (skills/nav.md)
  • Layout (ViewThatFits, AnyLayout) → See axiom-swiftui (skills/layout.md)
  • Animations → See axiom-swiftui (skills/animation-ref.md)
Data & persistence
  • SwiftData, Core Data, GRDB → See axiom-data
  • CloudKit sync → See axiom-data
Concurrency
  • Swift 6 concurrency, actors, Sendable → See axiom-concurrency
Other
  • Accessibility (VoiceOver, Dynamic Type) → See axiom-accessibility
  • Networking (URLSession, Network.framework) → See axiom-networking
  • Security (Keychain, passkeys, encryption) → See axiom-security

Conflict Resolution

axiom-macos vs axiom-swiftui: When working on a macOS SwiftUI app:

  1. Use axiom-macos for macOS-only concerns: windows, menus, commands, sandboxing, distribution, Table, Inspector, AppKit bridging
  2. Use axiom-swiftui for cross-platform SwiftUI: navigation, layout, state management, animations
  3. Both may apply: A macOS app using NavigationSplitView with Table needs axiom-macos for Table specifics and axiom-swiftui for NavigationSplitView basics

axiom-macos vs axiom-security: For sandbox and code signing:

  1. Use axiom-macos for macOS App Sandbox, security-scoped bookmarks, file access entitlements, Developer ID signing
  2. Use axiom-security for Keychain storage, encryption, passkeys, certificate management

Decision Tree

digraph macos {
    start [label="macOS development task" shape=ellipse];
    what [label="What area?" shape=diamond];

    start -> what;
    what -> "skills/windows.md" [label="windows/scenes"];
    what -> "skills/menus-and-commands.md" [label="menus/commands/shortcuts"];
    what -> "skills/swiftui-differences.md" [label="Table/Inspector/focus/macOS SwiftUI"];
    what -> "skills/sandbox-and-file-access.md" [label="sandbox/file access"];
    what -> "skills/direct-distribution.md" [label="distribution/notarization/updates"];
    what -> "skills/appkit-interop.md" [label="AppKit bridging"];
    what -> "skills/appkit-modernization.md" [label="modernize AppKit\n(input/restoration/27 look)"];
    what -> "skills/ios-apps-on-mac.md" [label="iOS app to Mac\n(Catalyst / Designed for iPad)"];
    what -> "skills/screencapturekit.md" [label="screen capture/\nrecording/sharing"];
    what -> "axiom-swiftui" [label="cross-platform SwiftUI"];
    what -> "axiom-security" [label="Keychain/encryption"];
}

iOS screen capture? ScreenCaptureKit is macOS-only. For iOS screen recording, use ReplayKit — see axiom-media.

Resources

WWDC: 2021-10062, 2022-10061, 2022-10075, 2023-10148, 2024-10149, 2026-272, 2026-289

Docs: /security/app-sandbox, /swiftui/windowgroup, /swiftui/table

Skills: axiom-swiftui, axiom-security, axiom-concurrency, axiom-uikit

Comments

Markdown supported