skills.rest
oliverames
oliveramesCOMMUNITY
Explore all skills by this author →
GitHub

build-run-debug

Automate building, running, and debugging macOS apps via Xcode and Swift workflows.

Updated Aug 23, 2026
Search Tags:#automation#debugging#build#swift#macos#xcode#gui-app
One-click install
npx skills add https://github.com/oliverames/ames-claude --skill build-run-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-run-debug
Source: https://github.com/oliverames/ames-claude/tree/main/plugins/build-macos-apps-codex/skills/build-run-debug
Command: npx skills add https://github.com/oliverames/ames-claude --skill build-run-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This skill automates the process of building, running, and debugging local macOS applications by guiding shell-first Xcode and Swift workflows. It helps developers quickly diagnose compiler or linker failures, startup problems, and desktop-runtime issues without manual, ad-hoc commands.

Core Features & Use Cases

  • Set up a project-local script build_and_run.sh to own the kill-build-run workflow.
  • Use project-local SwiftPM or Xcode workflows to discover targets, build, and launch either a CLI tool or a GUI app bundled as a .app.
  • Provide optional run-time inspection capabilities with flags like --debug, --logs, --telemetry, and --verify to aid debugging and validation.

Quick Start

Follow the canonical bootstrap to create script/build_and_run.sh, configure .codex/environments/environment.toml Run action, and use the Run button to execute the Mac build/run workflow.

Frequently Asked Questions about build-run-debug

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

FAQPage Schema
How do I automate building and running a macOS app from the shell?▼

You can automate building and running a macOS app by setting up a project-scoped script like build_and_run.sh to handle the kill-build-run workflow using shell-first Xcode and Swift commands.

Can I debug a SwiftPM GUI app bundled as a .app file?▼

Yes, you can debug a SwiftPM GUI app by using a project-local workflow that discovers the runnable target, generates the correct .app artifact, and launches it with the --debug flag for inspection.

How do I configure Xcode workflows to launch a local macOS desktop project?▼

You configure Xcode workflows by setting up a local environment at .codex/environments/environment.toml and defining a Run action that executes your build_and_run.sh script to launch the desktop project.

What is the best way to diagnose compiler and linker failures in a local macOS app?▼

The best way to diagnose compiler and linker failures is to use an automated shell-first build workflow that surfaces errors during artifact generation, preventing the need for manual ad-hoc commands.

What run-time flags can I use to inspect telemetry and logs for a macOS app?▼

You can use the --logs, --telemetry, --verify, and --debug run-time flags when launching your macOS app to capture logs, inspect telemetry, and validate runtime behavior.

Does this build and run workflow support both CLI tools and GUI apps?▼

Yes, the workflow supports both CLI tools and GUI apps by discovering the appropriate project target and building the correct artifact, whether it is a command-line tool or a bundled .app.

Related Skills

Explore More Software Engineering Skills→
mlhitermlhiter
14

codex-runner-creator

Create and validate Codex environment.toml files with startup commands.

Community
Advanced
se1111thse1111th

fetch-deployment-logs

Fetch and analyze deployment logs to diagnose live application issues.

Community
Intermediate
Roy-wonjiRoy-wonji

guide-macos-spm-packaging

Scaffold, build, sign, and package SwiftPM macOS apps into .app bundles.

Community
Advanced
robinebersrobinebers
46

macos-build-run-debug

Automates building, running, and debugging macOS apps with Xcode and Swift workflows.

Community
Advanced