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.
- Author
- artemnovichkov ↗
- Repository
- skills ↗
- Licence
- MIT
- Last repository change
- 17.10.2026
Assessment and security
- Files in this package
- 6
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 17.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 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
- When to Use
- How It Works
- Requirements
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…