artemnovichkov avatar

xcodebuild-notify

macOS notifications for xcodebuild commands, mimicking Xcode's build notifications

version
1.0.0
GitHub stars
43

Install

/plugin install xcodebuild-notify@skills

Run it inside Claude Code after adding the marketplace with /plugin marketplace add artemnovichkov/skills.

Contents

Discovered from source

Skills 1

xcodebuild-notify

macOS notifications for xcodebuild commands, mimicking Xcode's native build notifications.

When to Use

This skill activates automatically via a PostToolUse hook on Bash commands. No manual invocation needed — any xcodebuild command triggers it.

How It Works

The hook script (hooks/scripts/xcodebuild-notify.sh) runs after every Bash tool use:

  1. Checks if the command contains xcodebuild — exits early if not
  2. Parses -scheme and -project flags from the command
  3. Checks tool output for BUILD SUCCEEDED or BUILD FAILED
  4. Sends a macOS notification via osascript

Hook Configuration

The PostToolUse hook is defined in hooks/hooks.json:

{
  "PostToolUse": [
    {
      "matcher": "Bash",
      "hooks": [
        {
          "type": "command",
          "command": "bash $CLAUDE_PLUGIN_ROOT/hooks/scripts/xcodebuild-notify.sh",
          "async": true
        }
      ]
    }
  ]
}

Notification Examples

Build succeeds:

Title: "Build Succeeded"
Body:  "MyScheme | MyApp Project"

Build fails:

Title: "Build Failed"
Body:  "MyScheme | MyApp Project"

Commands that don't produce BUILD SUCCEEDED or BUILD FAILED (e.g., xcodebuild clean, xcodebuild -help) are silently skipped.

Requirements

  • macOS (uses osascript for notifications)
  • jq (brew install jq) — parses hook input JSON

Sponsors

Details

Marketplace
artemnovichkov/skills
Source
skills/xcodebuild-notify
Author
Artem Novichkov
Category
Development

More from artemnovichkov/skills

All 6