Slash Command

/build-and-run-macos-app

Create or update the project-local macOS `build_and_run.sh` script,

npx claudepluginhub freak4pc/codex-curated-plugins --plugin build-macos-apps

Popularity

Parent stars

Invocation

How this command is triggered — by the user, by Claude, or both

Slash command

/build-macos-apps:build-and-run-macos-app

Model invocable

No pre-commands

Context Preview

The summary Claude sees in its command listing — used to decide when to auto-load this command

# /build-and-run-macos-app

Create or update the project-local macOS `build_and_run.sh` script,
then use that script as the default build/run entrypoint.

## Arguments

- `scheme`: Xcode scheme name (optional)
- `workspace`: path to `.xcworkspace` (optional)
- `project`: path to `.xcodeproj` (optional)
- `product`: SwiftPM executable product name (optional)
- `mode`: `run`, `debug`, `logs`, `telemetry`, or `verify` (optional, default: `run`)
- `app_name`: process/app name to stop before relaunching (optional)

## Workflow

1. Detect whether the repo uses an Xcode workspace, Xcode project, o...

Command Content

30 lines · ~392 tokens

Stats

Parent stars2

MaintenanceGood

Last CommitApr 8, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Stats

Actions

Help us improve

Share bugs, ideas, or general feedback.

# /build-and-run-macos-app Create or update the project-local macOS `build_and_run.sh` script, then use that script as the default build/run entrypoint. ## Arguments - `scheme`: Xcode scheme name (optional) - `workspace`: path to `.xcworkspace` (optional) - `project`: path to `.xcodeproj` (optional) - `product`: SwiftPM executable product name (optional) - `mode`: `run`, `debug`, `logs`, `telemetry`, or `verify` (optional, default: `run`) - `app_name`: process/app name to stop before relaunching (optional) ## Workflow 1. Detect whether the repo uses an Xcode workspace, Xcode project, o...

/build-and-run-macos-app

Create or update the project-local macOS build_and_run.sh script, then use that script as the default build/run entrypoint.

Arguments

scheme: Xcode scheme name (optional)

workspace: path to .xcworkspace (optional)

project: path to .xcodeproj (optional)

product: SwiftPM executable product name (optional)

mode: run, debug, logs, telemetry, or verify (optional, default: run)

app_name: process/app name to stop before relaunching (optional)

Workflow

Detect whether the repo uses an Xcode workspace, Xcode project, or SwiftPM package.

If the workspace is not inside git yet, run git init at the project root.

Create or update script/build_and_run.sh so it always stops the current app, builds the macOS target, and launches the fresh result.

For SwiftPM, keep raw executable launch only for true CLI tools; for AppKit/SwiftUI GUI apps, create a project-local .app bundle and launch it with /usr/bin/open -n.

Support optional script flags for --debug, --logs, --telemetry, and --verify.

Follow the canonical bootstrap contract in ../skills/build-run-debug/references/run-button-bootstrap.md for the exact script shape.

Run the script in the requested mode and summarize any build, script, or launch failure.

Guardrails

Do not initialize a nested git repo inside an existing parent checkout.

Keep the no-flag script path simple: kill, build, run.

Use --debug, --logs, --telemetry, or --verify only when the user asks for those modes.