# Send Apple Developer Toolkit to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "apple-developer-toolkit",
    "name": "Apple Developer Toolkit",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Abdullah4AI/apple-developer-toolkit",
    "canonicalUrl": "https://clawhub.ai/Abdullah4AI/apple-developer-toolkit",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/apple-developer-toolkit",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-developer-toolkit",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "_meta.json",
      "build-wwdc-index.js",
      "cli.js",
      "hooks/generate-changelog.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/apple-developer-toolkit"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/apple-developer-toolkit",
    "downloadUrl": "https://openagent3.xyz/downloads/apple-developer-toolkit",
    "agentUrl": "https://openagent3.xyz/skills/apple-developer-toolkit/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-developer-toolkit/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-developer-toolkit/agent.md"
  }
}
```
## Documentation

### Apple Developer Toolkit

Three tools in one binary. Each part works independently with different credential requirements.

### Architecture

Ships as a single unified binary appledev with multi-call support:

appledev build ...    # iOS app builder (SwiftShip)
appledev store ...    # App Store Connect CLI
appledev b ...        # Short alias
appledev s ...        # Short alias

One binary, three tools, zero duplication.

### Credential Requirements by Feature

FeatureCredentials NeededWorks Without SetupDocumentation Search (Part 1)NoneYesApp Store Connect (Part 2)App Store Connect API key (.p8)NoiOS App Builder (Part 3)LLM API key + XcodeNo

### Part 1: Documentation Search (no setup needed)

Works immediately with Node.js:

node cli.js search "NavigationStack"

### Part 2: App Store Connect CLI

Install via Homebrew:

brew install Abdullah4AI/tap/appledev

Authenticate with your App Store Connect API key:

appledev store auth login --name "MyApp" --key-id "KEY_ID" --issuer-id "ISSUER_ID" --private-key /path/to/AuthKey.p8

Or set environment variables:

export APPSTORE_KEY_ID="your-key-id"
export APPSTORE_ISSUER_ID="your-issuer-id"
export APPSTORE_PRIVATE_KEY_PATH="/path/to/AuthKey.p8"

API keys are created at https://appstoreconnect.apple.com/access/integrations/api

### Part 3: iOS App Builder

Prerequisites: Xcode (with iOS Simulator), XcodeGen, and an LLM API key for code generation.

appledev build setup    # Checks and installs prerequisites

### Build from source

bash scripts/setup.sh

### Part 1: Documentation Search

node cli.js search "NavigationStack"
node cli.js symbols "UIView"
node cli.js doc "/documentation/swiftui/navigationstack"
node cli.js overview "SwiftUI"
node cli.js samples "SwiftUI"
node cli.js wwdc-search "concurrency"
node cli.js wwdc-year 2025
node cli.js wwdc-topic "swiftui-ui-frameworks"

### Part 2: App Store Connect

Full reference: references/app-store-connect.md

TaskCommandList appsappledev store appsUpload buildappledev store builds upload --app "APP_ID" --ipa "app.ipa" --waitFind build by numberappledev store builds find --app "APP_ID" --build-number "42"Wait for build processingappledev store builds wait --build "BUILD_ID"Publish TestFlightappledev store publish testflight --app "APP_ID" --ipa "app.ipa" --group "Beta" --waitSubmit App Storeappledev store publish appstore --app "APP_ID" --ipa "app.ipa" --submit --confirm --waitPre-submission validationappledev store validate --app "APP_ID" --version-id "VERSION_ID"List certificatesappledev store certificates listReviewsappledev store reviews --app "APP_ID" --output tableUpdate localizationsappledev store localizations update --app "APP_ID" --locale "en-US" --name "My App"Sales reportappledev store analytics sales --vendor "VENDOR" --type SALES --subtype SUMMARY --frequency DAILY --date "2024-01-20"Xcode Cloudappledev store xcode-cloud run --app "APP_ID" --workflow "CI" --branch "main" --waitNotarizeappledev store notarization submit --file ./MyApp.zip --waitStatus dashboardappledev store status --app "APP_ID" --output tableWeekly insightsappledev store insights weekly --app "APP_ID" --source analyticsMetadata pullappledev store metadata pull --app "APP_ID" --version "1.2.3" --dir ./metadataRelease notesappledev store release-notes generate --since-tag "v1.2.2"Diff localizationsappledev store diff localizations --app "APP_ID" --path ./metadataNominationsappledev store nominations create --app "APP_ID" --name "Launch"Price point filterappledev store pricing price-points --app "APP_ID" --price 0.99IAP (family sharable)appledev store iap create --app "APP_ID" --family-sharableSubscription (family sharable)appledev store subscriptions create --app "APP_ID" --family-sharable

### Environment Variables

All environment variables are optional. They override flags when set.

VariableDescriptionAPPSTORE_KEY_IDAPI Key IDAPPSTORE_ISSUER_IDAPI Issuer IDAPPSTORE_PRIVATE_KEY_PATHPath to .p8 key fileAPPSTORE_PRIVATE_KEYRaw private key stringAPPSTORE_PRIVATE_KEY_B64Base64-encoded private keyAPPSTORE_APP_IDDefault app IDAPPSTORE_PROFILEDefault auth profileAPPSTORE_DEBUGEnable debug outputAPPSTORE_TIMEOUTRequest timeoutAPPSTORE_BYPASS_KEYCHAINSkip system keychain

### Part 3: Multi-Platform App Builder

Supports iOS, watchOS, tvOS, and iPad. Generates complete Swift/SwiftUI apps from natural language with AI-powered code generation.

appledev build                     # Interactive mode
appledev build setup               # Install prerequisites (Xcode, XcodeGen, AI backend)
appledev build fix                 # Auto-fix build errors
appledev build run                 # Build and launch in simulator
appledev build open                # Open project in Xcode
appledev build chat                # Interactive chat mode (edit/ask questions)
appledev build info                # Show project status
appledev build usage               # Token usage and cost

### Supported Platforms

PlatformStatusiOSFull supportiPadFull supportmacOSSupportedwatchOSSupportedtvOSSupportedvisionOSSupported

### How it works

describe > analyze > plan > build > fix > run

Analyze - Extracts app name, features, core flow, target platform from description
Plan - Produces file-level build plan: data models, navigation, design
Build - Generates Swift source files, project.yml, asset catalog
Fix - Compiles and auto-repairs until build succeeds
Run - Boots Simulator and launches the app

### Interactive commands

CommandDescription/runBuild and launch in simulator/fixAuto-fix compilation errors/openOpen project in Xcode/ask [question]Ask a question about the project/model [name]Switch model (sonnet, opus, haiku)/infoShow project info/usageToken usage and cost

### Hooks

The toolkit supports lifecycle hooks for automation. Hooks fire at key points during build and store operations, running scripts or sending notifications.

### Quick Start

# Initialize hook system with indie dev template
bash scripts/hook-init.sh --template indie

# Test a hook
bash scripts/hook-runner.sh build.done STATUS=success APP_NAME=MyApp DURATION_SEC=42

# Dry run (preview without executing)
bash scripts/hook-runner.sh --dry-run build.done STATUS=success APP_NAME=MyApp

# Per-project hooks
bash scripts/hook-init.sh --template indie --project

### Config Locations

Global: ~/.appledev/hooks.yaml (applies to all projects)
Project: .appledev/hooks.yaml (overrides/extends global)
Hook scripts: ~/.appledev/hooks/ (reusable shell scripts)
Logs: ~/.appledev/hook-logs/ (daily execution logs)

### Templates

Three templates available via hook-init.sh --template:

TemplateFocusindieSolo dev: Telegram notifications, auto TestFlightteamTeam: Slack + Telegram, git tagging, changelogciCI/CD: Logging, test running, no interactive notifications

### Built-in Hook Scripts

ScriptPurposenotify-telegram.shSend Telegram notificationgit-tag-release.shCreate and push git tagrun-swift-tests.shRun Swift tests (SPM or Xcode)generate-changelog.shGenerate changelog from git history

### Event Catalog

42 events across 4 categories: build (13), store (20), docs (4), pipeline (5). Full reference: references/hooks-reference.md

### Agent Integration

When running appledev commands via the skill, fire appropriate hook events after completion:

# After appledev build completes
bash scripts/hook-runner.sh build.done STATUS=success APP_NAME=AppName DURATION_SEC=30

# After store upload
bash scripts/hook-runner.sh store.upload.done STATUS=success APP_ID=123 BUILD_NUMBER=42

### References

ReferenceContentreferences/app-store-connect.mdComplete App Store Connect CLI commandsreferences/ios-rules/38 iOS development rulesreferences/swiftui-guides/12 SwiftUI best practice guidesreferences/ios-app-builder-prompts.mdSystem prompts for app building

### iOS Rules (38 files)

accessibility, app_clips, app_review, apple_translation, biometrics, camera, charts, color_contrast, components, dark_mode, design-system, feedback_states, file-structure, forbidden-patterns, foundation_models, gestures, haptics, healthkit, live_activities, localization, maps, mvvm-architecture, navigation-patterns, notification_service, notifications, safari_extension, share_extension, siri_intents, spacing_layout, speech, storage-patterns, swift-conventions, timers, typography, view-composition, view_complexity, website_links, widgets

### SwiftUI Guides (12 files)

animations, forms-and-input, layout, liquid-glass, list-patterns, media, modern-apis, navigation, performance, scroll-patterns, state-management, text-formatting
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Abdullah4AI
- Version: 1.260308.2
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/apple-developer-toolkit)
- [Send to Agent page](https://openagent3.xyz/skills/apple-developer-toolkit/agent)
- [JSON manifest](https://openagent3.xyz/skills/apple-developer-toolkit/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/apple-developer-toolkit/agent.md)
- [Download page](https://openagent3.xyz/downloads/apple-developer-toolkit)