build-macos-apps — плагин для Codex: сборка и отладка macOS-приложений
Плагин для Codex с набором скиллов под разработку локальных macOS-приложений: сборка, запуск, тесты, подпись и логирование.
Открыть на GitHubЧто делает build-macos-apps
Плагин лежит в plugins/build-macos-apps и собирает рабочие процессы под macOS в один набор скиллов. Внутри одиннадцать штук: build-run-debug, test-triage, signing-entitlements, swiftpm-macos, packaging-notarization, swiftui-patterns, liquid-glass, window-management, appkit-interop, view-refactor, telemetry.
Основной режим — shell-first. Скиллы ищут локальные Xcode-воркспейсы, проекты и Swift-пакеты, собирают и запускают приложения через xcodebuild, swift, open, lldb, codesign, spctl, plutil и log stream. Отдельно плагин создаёт проектный script/build_and_run.sh и прописывает .codex/environments/environment.toml, чтобы кнопка Run в приложении Codex работала.
Есть и слой десктопного UI: сцены SwiftUI, меню, настройки, тулбары, многооконные сценарии, мосты в AppKit через representables и responder chain, рефакторинг больших файлов представлений. Логирование — через Logger и os.Logger для окон, сайдбаров и команд меню, с проверкой событий в Console. Чего здесь нет: управления симуляторами iOS, watchOS и tvOS, автоматизации десктопного UI, релизов в App Store Connect и генерации дизайн-системы. Если ваш проект — iOS-приложение, это не тот плагин, смотрите plugins/build-ios-apps.
Плагин не поставляет собственный .mcp.json, на уровне плагина он skills-first.
Какие задачи решает
- собрать и запустить macOS-приложение из шелла без ручного тыканья в Xcode
- разобрать падение на старте, краш или ошибку линковки
- прочитать рантайм-события через
log streamи Console - проверить signing identity, entitlements и hardened runtime
- подготовить упаковку и нотаризацию для распространения
Примеры запросов агенту
- собери и запусти это macOS-приложение, найди воркспейс сам
- тесты падают на UI-хосте — разберись, что не так
- настрой логирование окон и команд меню через os.Logger
Вопросы о build-macos-apps
Как установить build-macos-apps в Claude?
Плагин лежит в репозитории openai/plugins в каталоге plugins/build-macos-apps. Скопируйте его в свой проект или подключите как плагин Claude, следуя структуре: манифест .codex-plugin/plugin.json указывает Claude на содержимое.
Что делает build-macos-apps?
Даёт Claude набор скиллов под локальную разработку macOS-приложений: сборка и запуск, триаж тестов, подпись и entitlements, SwiftPM, упаковка и нотаризация, паттерны SwiftUI, работа с окнами, AppKit-интероп, рефакторинг представлений и телеметрия.
Чем build-macos-apps отличается от build-ios-apps?
Он не предполагает инструментов симулятора и инспекции тач-интерфейса. Основной режим — shell-first на xcodebuild, swift, lldb и codesign, плюс слой нативного SwiftUI и AppKit. iOS, watchOS и tvOS он не покрывает.
Исходный текст
build-macos-apps · MIT
# Build macOS Apps Plugin
This plugin packages macOS-first development workflows in `plugins/build-macos-apps`.
It currently includes these skills:
- `build-run-debug`
- `test-triage`
- `signing-entitlements`
- `swiftpm-macos`
- `packaging-notarization`
- `swiftui-patterns`
- `liquid-glass`
- `window-management`
- `appkit-interop`
- `view-refactor`
- `telemetry`
## What It Covers
- discovering local Xcode workspaces, projects, and Swift packages
- building and running macOS apps with shell-first desktop workflows
- creating one project-local `script/build_and_run.sh` entrypoint and wiring `.codex/environments/environment.toml` so the Codex app Run button works
- implementing native macOS SwiftUI scenes, menus, settings, toolbars, and multiwindow flows
- adopting modern macOS Liquid Glass and design-system guidance with standard SwiftUI structures, toolbars, search, controls, and custom glass surfaces
- tailoring SwiftUI windows with title/toolbar styling, material-backed container backgrounds, minimize/restoration behavior, default and ideal placement, borderless window style, and launch behavior
- bridging into AppKit for representables, responder-chain behavior, panels, and other desktop-only needs
- refactoring large macOS view files toward stable scene, selection, and command structure
- adding lightweight `Logger` / `os.Logger` instrumentation for windows, sidebars, menu commands, and menu bar actions
- reading and verifying runtime events with Console, `log stream`, and process logs
- triaging failing unit, integration, and UI-hosted macOS tests
- debugging launch failures, crashes, linker problems, and runtime regressions
- inspecting signing identities, entitlements, hardened runtime, and Gatekeeper issues
- preparing packaging and notarization workflows for distribution
## What It Does Not Cover
- iOS, watchOS, or tvOS simulator control
- desktop UI automation
- App Store Connect release management
- pixel-perfect visual design or design-system generation
## Plugin Structure
The plugin lives at:
- `plugins/build-macos-apps/`
with this shape:
- `.codex-plugin/plugin.json`
- required plugin manifest
- defines plugin metadata and points Codex at the plugin contents
- `agents/`
- plugin-level agent metadata
- currently includes `agents/openai.yaml` for the OpenAI surface
- `commands/`
- reusable workflow entrypoints for common macOS development tasks
- `skills/`
- the actual skill payload
- each skill keeps the normal skill structure (`SKILL.md`, optional
`agents/`, `references/`, `assets/`, `scripts/`)
## Notes
This plugin is currently skills-first at the plugin level. It does not ship a
plugin-local `.mcp.json`, matching the public `plugins/build-ios-apps` shape.
The default posture is shell-first. Unlike the iOS build plugin, this plugin
does not assume simulator tooling or touch-driven UI inspection for its main
workflows. The core execution model leans on `xcodebuild`, `swift`, `open`,
`lldb`, `codesign`, `spctl`, `plutil`, and `log stream`, with a compact desktop
UI layer for native SwiftUI scene design, AppKit interop, and macOS-specific
refactoring.
© OpenAI · MIT · openai/plugins
