apple-developer-toolkit

$ appledev build

> A habit tracker with streak counting and weekly grid

  ✓ Analyzed: StreakGrid
  ✓ Plan ready (11 files, 3 models)
  ✓ Build complete — 11 files
  ✓ Launched on iPhone 17 Pro

Ships as a single unified binary appledev with three independent tools. Each works on its own with different credential requirements.

Install

brew install Abdullah4AI/tap/appledev

git clone https://github.com/Abdullah4AI/apple-developer-toolkit.git
cd apple-developer-toolkit
bash scripts/setup.sh

Agent Skills

Add iOS and SwiftUI knowledge to any AI coding agent — Claude Code, Codex, Cursor, Windsurf, Gemini CLI, and more:

# Install both skills (recommended)
npx skills add Abdullah4AI/apple-developer-toolkit

# Install a specific skill
npx skills add Abdullah4AI/apple-developer-toolkit --skill ios-rules
npx skills add Abdullah4AI/apple-developer-toolkit --skill swiftui-guides

Skills work out of the box with any agent that supports the Agent Skills format, including Claude Code, Codex, Cursor, Windsurf, Gemini CLI, and other compatible coding agents.

What's Inside

Codex Build iOS/macOS Workflows in the CLI

The Build iOS Apps and Build macOS Apps Codex plugin workflows are exposed directly through appledev:

appledev ios features
appledev ios doctor
appledev ios mcp-config
appledev ios simulators
appledev ios build --workspace App.xcworkspace --scheme App --device "iPhone 17 Pro"
appledev ios screenshot --sim <UDID> --output /tmp/app.png
appledev ios mirror --sim <UDID>
appledev ios memgraph --sim <UDID> --process App

appledev macos features
appledev macos doctor
appledev macos bootstrap --app-name MyApp --scheme MyApp --project MyApp.xcodeproj
appledev macos bootstrap --app-name MyApp --product MyApp
appledev macos run --mode verify
appledev macos logs --process MyApp
appledev macos codesign-inspect --path dist/MyApp.app

These commands bring the plugin features into the CLI: iOS Simulator build/run/debug/log/UI workflows, scoped serve-sim mirroring, ETTrace and memgraph workflow entrypoints, macOS project-local script/build_and_run.sh, SwiftPM GUI .app staging, signing/entitlement inspection, and log/telemetry loops.

Supported Platforms

Mention any Apple platform in your prompt — combine as many as you want:

Default

"iPad"

"Apple Watch"

"Mac"

"Apple TV"

"Vision Pro"

Frameworks

Apps use Apple-first frameworks wherever possible:

SwiftUI UI	SwiftData Persistence	Swift Charts Data viz	MapKit Maps	HealthKit Health	WidgetKit Widgets
AVFoundation Camera & media	PhotosUI Photo picker	ActivityKit Live Activities	CoreML ML	ARKit AR	RealityKit 3D & spatial

Deploy

Ship to the App Store and TestFlight without leaving the terminal.

App Store Full submission

TestFlight Beta distribution

Integrations

Mention authentication, a database, or a paid feature, and the toolkit wires up the supported backend automatically.

RevenueCat Subscriptions & paywalls

Supabase Auth, database, storage

Telegram Build & review notifications

Slack Team notifications

Git Auto-tagging releases

Documentation Search

Search Apple frameworks, symbols, and WWDC sessions locally. No API key needed.

node cli.js search "NavigationStack"        # Framework search
node cli.js symbols "UIView"                # Symbol lookup
node cli.js doc "/documentation/swiftui/view" # Full docs
node cli.js overview "SwiftUI"              # Framework overview
node cli.js samples "SwiftUI"               # Sample code

node cli.js wwdc-search "concurrency"       # Search WWDC talks
node cli.js wwdc-year 2025                  # Browse by year
node cli.js wwdc-topic "swiftui-ui-frameworks" # Browse by topic

App Store Connect

120+ commands covering the full App Store Connect API.

# Authenticate
appledev store auth login --name "MyApp" \
  --key-id "KEY_ID" --issuer-id "ISSUER_ID" \
  --private-key ./AuthKey.p8

# Ship to TestFlight
appledev store publish testflight \
  --app "APP_ID" --ipa app.ipa --group "Beta" --wait

# Submit to App Store
appledev store publish appstore \
  --app "APP_ID" --ipa app.ipa --submit --confirm --wait

# Pre-submission validation
appledev store validate --app "APP_ID" --version-id "VER_ID"

App Builder

Build complete multi-platform Apple apps from natural language.

> A recipe app with ingredients list, step-by-step instructions, and a timer

  ✓ Analyzed: RecipeBook
  ✓ Plan ready (16 files, 4 models)
  ✓ Build complete — 16 files
  ✓ RecipeBook is ready!

How It Works

describe  →  analyze  →  plan  →  build  →  fix  →  run
   ↑            │          │        │        │       │
 prompt     app name    files    Swift    xcode-   iOS
            features    models   code     build    Simulator

Commands

Lifecycle Hooks

42 events across 4 categories. Get notified on Telegram, auto-distribute to TestFlight, git-tag releases, and chain operations into pipelines.

# Set up hooks with a template
bash scripts/hook-init.sh --template indie

# Fire a hook manually
bash scripts/hook-runner.sh build.done STATUS=success APP_NAME=MyApp

# Dry run
bash scripts/hook-runner.sh --dry-run build.done STATUS=success

Templates

Built-in Scripts

version: 1
notifiers:
  telegram:
    enabled: true
    bot_token_keychain: "my-bot-token"
    chat_id: "123456"
  feishu:
    enabled: true
    webhook_url_env: "FEISHU_WEBHOOK_URL"

hooks:
  build.done:
    - name: notify-build
      notify: telegram
      template: "{{if eq .STATUS \"success\"}}✅{{else}}❌{{end}} {{.APP_NAME}} build"
    - name: notify-build-feishu
      notify: feishu
      template: "{{if eq .STATUS \"success\"}}✅{{else}}❌{{end}} {{.APP_NAME}} build"

  store.review.approved:
    - name: tag-release
      run: "git tag v{{.VERSION}} && git push origin v{{.VERSION}}"

AI Agent References

52 reference files for AI-assisted development:

Requirements

Download History