build-macos-apps

v0.1.4

Build, run, test, debug, instrument, and implement local macOS apps using Xcode, SwiftUI, AppKit interop, unified logging, and shell-first desktop workflows.

Codex11 skills

by OpenAIMIT5kupdated 3 weeks ago

Source

$ git clone https://github.com/openai/plugins

Clone the source, then follow the repository's marketplace instructions for your runtime. The plugin root is plugins/build-macos-apps/ inside the repository.

Layout

plugins/build-macos-apps/

├── .codex-plugin/plugin.json
├── skills/appkit-interop/SKILL.md
├── skills/build-run-debug/SKILL.md
├── skills/liquid-glass/SKILL.md
├── skills/packaging-notarization/SKILL.md
├── skills/signing-entitlements/SKILL.md
├── skills/swiftpm-macos/SKILL.md
├── skills/swiftui-patterns/SKILL.md
├── skills/telemetry/SKILL.md
├── skills/test-triage/SKILL.md
├── skills/view-refactor/SKILL.md
└── skills/window-management/SKILL.md

Skills11

appkit-interopskills/appkit-interop/SKILL.md

Bridge macOS SwiftUI into AppKit narrowly. Use when implementing representables, reaching NSWindow or panels, handling menus, or using the responder chain.

build-run-debugskills/build-run-debug/SKILL.md

Build, run, and debug macOS apps with shell-first Xcode and Swift workflows. Use when launching apps or diagnosing build, startup, or runtime failures.

liquid-glassskills/liquid-glass/SKILL.md

Implement and review macOS SwiftUI Liquid Glass UI. Use when adopting system glass, removing conflicting custom chrome, or building glass surfaces.

packaging-notarizationskills/packaging-notarization/SKILL.md

Prepare macOS packaging and notarization workflows. Use when archiving apps, validating bundles, or explaining distribution-only failures.

signing-entitlementsskills/signing-entitlements/SKILL.md

Inspect macOS signing, entitlements, and Gatekeeper issues. Use when diagnosing code signing, sandbox, hardened runtime, or trust failures.

swiftpm-macosskills/swiftpm-macos/SKILL.md

Build, run, and test SwiftPM macOS packages and executables. Use when the repo is package-first or has no Xcode project.

swiftui-patternsskills/swiftui-patterns/SKILL.md

Build macOS SwiftUI scenes and components with desktop patterns. Use when shaping windows, commands, toolbars, settings, split views, or inspectors.

telemetryskills/telemetry/SKILL.md

Add and verify lightweight macOS runtime telemetry. Use when wiring Logger events or inspecting logs for windows, sidebars, menus, and actions.

test-triageskills/test-triage/SKILL.md

Triage macOS tests across Xcode and SwiftPM. Use when narrowing failures, explaining assertions or crashes, or separating setup from regressions.

view-refactorskills/view-refactor/SKILL.md

Refactor macOS SwiftUI views and scenes into stable structure. Use when splitting large views, tightening scene state, or narrowing AppKit escapes.

window-managementskills/window-management/SKILL.md

Customize macOS SwiftUI windows and scene behavior. Use when tuning window chrome, drag regions, placement, restoration, launch behavior, or borderless windows.

Manifests1

plugins/build-macos-apps/.codex-plugin/plugin.json

{
  "name": "build-macos-apps",
  "version": "0.1.4",
  "description": "Build, run, test, debug, instrument, and implement local macOS apps using Xcode, SwiftUI, AppKit interop, unified logging, and shell-first desktop workflows.",
  "author": {
    "name": "OpenAI",
    "email": "support@openai.com",
    "url": "https://openai.com/"
  },
  "homepage": "https://openai.com/",
  "repository": "https://github.com/openai/plugins",
  "license": "MIT",
  "keywords": [
    "macos",
    "swift",
    "swiftui",
    "appkit",
    "xcode",
    "swiftpm",
    "debugging",
    "codesign",
    "logging",
    "telemetry",
    "oslog"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Build macOS Apps",
    "shortDescription": "Build, debug, instrument, and implement macOS apps with SwiftUI and AppKit guidance",
    "longDescription": "macOS development workflows for discovering local projects, building and running desktop apps, implementing native SwiftUI scenes, bridging into AppKit when necessary, adding lightweight Logger telemetry, triaging test failures, inspecting signing and entitlements, and debugging desktop-specific build or runtime errors.",
    "developerName": "OpenAI",
    "category": "Developer Tools",
    "capabilities": [
      "Interactive",
      "Read",
      "Write"
    ],
    "websiteURL": "https://openai.com/",
    "privacyPolicyURL": "https://openai.com/policies/privacy-policy/",
    "termsOfServiceURL": "https://openai.com/policies/terms-of-use/",
    "defaultPrompt": [
      "Build/refactor native macOS UI, inspect AppKit interop, add telemetry, or debug a macOS app"
    ],
    "screenshots": [],
    "brandColor": "#1F6FEB",
    "composerIcon": "./assets/build-macos-apps-small.svg",
    "logo": "./assets/app-icon.png"
  }
}