Skip to content
Skills Library
Programming · Automation

xcodebuild-notify

/xcodebuild-notify

Sends macOS notifications after xcodebuild commands, showing Build Succeeded or Build Failed with scheme and project info. Mimics Xcode's native build notifications. Auto-triggers on xcodebuild via PostToolUse hook.

Repository
skills ↗
Licence
MIT
Last repository change
17.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 17.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: hooks/scripts/xcodebuild-notify.sh

What it does and when to use it

Sends macOS notifications after xcodebuild commands, showing Build Succeeded or Build Failed with scheme and project info. Mimics Xcode's native build notifications. Auto-triggers on xcodebuild via PostToolUse hook.

Original author description

Sends macOS notifications after xcodebuild commands, showing Build Succeeded or Build Failed with scheme and project info. Mimics Xcode's native build notifications. Auto-triggers on xcodebuild via PostToolUse hook.

How it works

  1. When to Use
  2. How It Works
  3. Requirements
Original SKILL.md headings · 60 lines, 184 words
SKILL.md preview
---
name: xcodebuild-notify
description: Sends macOS notifications after xcodebuild commands, showing Build Succeeded or Build Failed with scheme and project info. Mimics Xcode's native build notifications. Auto-triggers on xcodebuild via PostToolUse hook.
---

# 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`:

```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
Files in this package (6)
  • README.md 1 KB
  • SKILL.md 2 KB
  • .claude-plugin/plugin.json 1 KB
  • assets/notification.png 55 KB
  • hooks/hooks.json 1 KB
  • hooks/scripts/xcodebuild-notify.sh 1 KB

Versions

The database has no other skills named xcodebuild-notify.

Database snapshot: 13.11.2026 · package version 1504b5f69eb7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100xcodebuild
    Build, test, and archive iOS/macOS apps with xcodebuild and Xcode CLI tools. Use for CI integration, scheme management, simulator control, and build troubleshooting.
  • 95xcode-workflows
    Xcode build system guidance for xcodebuild operations. Use when building iOS projects, running tests, analyzing build failures, or configuring schemes. Covers build/clean/test operations, interpreting xcodebuild output, and troubleshooting common build errors.
  • 95build-deploy
    Build and deploy Xcode projects to Mac or iOS devices in one step. Use when user says "build and deploy", "deploy to iPad", "rebuild server", "install on device", or wants to test changes on a physical device. Handles xcodegen → xcodebuild → install → launch automatically.
  • 100run-device
    Build, install, and launch an iOS app on a physical iPhone or iPad entirely from the command line (no Xcode GUI), using xcodebuild + devicectl. Use when the user wants to run, test, or screenshot their app on a real device without opening Xcode.
  • 90shipping-swift-apps
    Ships native Swift/SwiftUI apps to TestFlight and the App Store with fastlane and xcodebuild — one App Store Connect API key for both, fastlane lanes scoped to metadata/pricing/subscriptions, headless `xcodebuild archive` + `-exportArchive destination=upload`, build numbers read…
  • 90apple-agent-toolchain
    Configure and verify safe tooling for AI-agent Apple development and release work. Use when setting up XcodeBuildMCP, its CLI, Xcode, simulators, xcodebuild, simctl, XCTest results, App Store Connect API, Transporter, browser automation, code signing diagnostics, tool…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.