build-macos-apps

Create, test, and deliver native macOS apps from the command line.

7|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/kvnloo/evolve --skill build-macos-apps-kvnloo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-macos-apps
Source: https://github.com/kvnloo/evolve/tree/main/.claude/skills/expertise/macos-apps
Command: npx skills add https://github.com/kvnloo/evolve --skill build-macos-apps-kvnloo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill empowers you to develop professional native macOS applications using Swift and SwiftUI/AppKit, entirely from the command line. It streamlines the entire app lifecycle—from scaffolding and building to debugging, testing, optimizing, and shipping—without needing Xcode's GUI, saving time and enabling automated, reproducible workflows.

Core Features & Use Cases

  • CLI-Driven Development: Create, build, run, and debug macOS apps using command-line tools like xcodegen, xcodebuild, and lldb, integrating seamlessly into your terminal-based workflow.
  • Comprehensive Observability: Analyze build errors, runtime logs, crashes, memory leaks, and network traffic using CLI tools, providing deep insights without opening Xcode.
  • Full Lifecycle Support: Provides detailed guidance for new app creation, adding features, writing tests, optimizing performance, and preparing for App Store or Developer ID distribution.
  • Use Case: Rapidly prototype a new macOS utility by generating a project, implementing a feature, and verifying it with CLI tests and logs, all within your terminal environment.

Quick Start

Ask to build a new macOS app. Claude will generate the project.yml and Swift files. Run xcodegen generate and xcodebuild build to compile your app. Launch the app with open ./build/Build/Products/Debug/MyApp.app.

Frequently Asked Questions about build-macos-apps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Can I build macOS apps without Xcode using only the command line?

Yes, you can build native macOS apps entirely from the CLI using xcodebuild, xcodegen, and Swift. This Skill guides you through project setup, compilation, debugging, testing, and shipping without opening Xcode's GUI, enabling fully automated workflows.

How do I create and build a macOS app from the command line?

Generate a project.yml configuration with xcodegen, define your Swift and SwiftUI/AppKit code, run xcodegen generate to create the Xcode project, then use xcodebuild build to compile. Launch the app with open ./build/Build/Products/Debug/MyApp.app.

What CLI tools do I need to debug macOS apps without Xcode?

Use lldb for interactive debugging, xcodebuild to capture build and runtime logs, and CLI utilities to analyze crashes, memory leaks, and network traffic. This Skill covers comprehensive observability techniques for CLI-based workflows.

Can I use SwiftUI and AppKit with CLI-only macOS development?

Yes, both frameworks work with CLI-based development. This Skill covers SwiftUI and AppKit patterns for Document-based apps, Menu Bar apps, Shoebox/Library apps, and App Extensions, plus integration with SwiftData and Core Data.

How do I prepare a macOS app for App Store or Developer ID distribution from the CLI?

This Skill provides security and compliance guidance including code signing and notarization workflows, allowing you to complete the entire release pipeline—build, test, optimize, and ship—without leaving the terminal.

Does CLI-only development work for building macOS utilities and menu bar apps?

Yes, xcodebuild and related CLI tools support all macOS app patterns including utilities, menu bar applications, and app extensions. This approach is ideal for rapidly prototyping and automating builds across different app types.