iOS Dev Agent

End-to-end iOS development kit for AI coding tools.

Build, ship, and manage App Store apps — from first line of code to App Store review.

---

The Problem

AI coding tools are powerful, but they don't know iOS. They generate deprecated APIs, break build rules, hardcode colors, skip accessibility, mix up architectures, and produce code that looks right but won't pass App Store review. You spend more time fixing the AI's output than writing code yourself.

What This Solves

iOS Dev Agent gives your AI tool deep iOS expertise — the same knowledge a senior iOS engineer carries in their head:

• Your code actually builds. 7 always-active rules enforce Swift 6 concurrency, SwiftUI-first architecture, AppTheme design tokens, and MVVM with @Observable. The AI can't generate UIKit storyboards, hardcoded colors, or deprecated APIs — it's blocked before the code is written.

• Your app is ready for the App Store. Skills cover the full lifecycle: scaffold a project with XcodeGen, build with xcodebuild, manage signing certificates, submit via asc CLI, handle TestFlight, localize metadata, and preflight for App Store Review rejection patterns.

• Your subscriptions just work. RevenueCat integration with live API validation — configure products, entitlements, offerings, and sync your catalog between App Store Connect and RevenueCat without touching a dashboard.

• Your Apple account is connected. Sign in to Apple Developer Portal directly from your AI tool — SRP-6a authentication with 2FA, register bundle IDs, manage certificates and provisioning profiles. No browser needed.

• Your AI catches its own mistakes. 8 autonomous agents validate code quality, audit security, resolve build errors, investigate crashes, and feed lessons back into the rules so the same mistake never happens twice.

50+ skills · 8 agents · 7 rules · 12 MCP tools · works with 14 AI coding tools · zero dependencies.

---

Install

Run from your iOS project directory:

npx ios-dev-agent

That's it. Auto-detects your tool, installs everything, done.

---

Per-Tool Install

Claude Code

Option A — Plugin (recommended):

claude plugin marketplace add moasq/ios-dev-agent
claude plugin install ios-dev-agent

Skills, agents, rules, hooks, and MCP servers activate automatically. Updates sync when the marketplace updates.

Option B — npx:

npx ios-dev-agent claude

Copies .claude/ with skills, rules, agents, scripts, hooks + .mcp.json with Apple auth MCP server.

Cursor

npx ios-dev-agent cursor

Installs .agents/skills/ + .cursor/rules/ in .mdc format + .cursor/mcp.json.

OpenAI Codex

npx ios-dev-agent codex

Installs .agents/skills/ + AGENTS.md + scripts/. Then run:

codex mcp add apple-auth -- python3 scripts/apple-auth-mcp-server.py

Windsurf

npx ios-dev-agent windsurf

Installs .agents/skills/ + .windsurf/rules/ + scripts/. Then add to ~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "apple-auth": { "command": "python3", "args": ["scripts/apple-auth-mcp-server.py"] } } }

Google Antigravity

npx ios-dev-agent antigravity

Installs .agents/skills/ + GEMINI.md + scripts/. Then add MCP to ~/.gemini/antigravity/mcp_config.json.

OpenCode

npx ios-dev-agent opencode

Installs .agents/skills/ + .opencode/rules/ + AGENTS.md. Then add mcpServers to opencode.json.

Amp

npx ios-dev-agent amp

Installs .agents/skills/ + AGENTS.md. Then add MCP to ~/.config/amp/settings.json.

JetBrains Junie

npx ios-dev-agent junie

Installs .agents/skills/ + AGENTS.md + .junie/mcp/mcp.json.

Cline

npx ios-dev-agent cline

Installs .agents/skills/ + .clinerules/. Add MCP via the Cline extension settings UI.

Roo Code

npx ios-dev-agent roo

Installs .agents/skills/ + .roo/rules/ + .roo/mcp.json.

Continue.dev

npx ios-dev-agent continue

Installs .agents/skills/ + .continue/rules/. Add MCP to .continue/mcpServers/.

GitHub Copilot · Gemini CLI · Goose

Copy .agents/ into your project and configure MCP per your tool's docs.

All tools

npx ios-dev-agent all

---

What's Included

Skills (50+)

Every skill is a SKILL.md following the open Agent Skills spec — works across all 14 supported tools.

SwiftUI & UI /swiftui · /layout · /navigation · /animations · /forms · /lists · /scroll-patterns · /charts · /feedback-states · /performance Apple Frameworks /healthkit · /foundation-models · /notifications · /apple-signin · /haptics · /accessibility · /storage

App Store Connect (asc CLI) /asc · /asc-release-flow · /asc-testflight-orchestration · /asc-metadata-sync · /asc-signing-setup · /asc-xcode-build · /asc-crash-triage · /asc-whats-new-writer · /asc-ppp-pricing · +11 more Build, Deploy & Workflow /build · /scaffold · /screenshots · /app-store-preflight · /revenuecat · /review · /debugging · /fix-error · /crash · /ui-ux-pro-max

Agents (8)

Agent	Description
app-validator	Checks AppTheme usage, MVVM compliance, forbidden patterns
code-cleaner	Finds dead code, redundancy, oversized files, unused imports
security-auditor	Audits HealthKit PHI exposure, credential storage, entitlements
test-runner	Runs Xcode build, analyzes errors and warnings
error-resolver	Investigates build errors, applies fixes, verifies build
crash-resolver	Investigates runtime crashes, reads logs, applies fixes
rules-consolidator	Feeds resolved errors back into rules to prevent recurrence
app-store-preflight	Scans for App Store Review rejection patterns

Rules (7)

Always active. Enforced on every file edit.

Rule	What it enforces
swift-conventions	Swift 6, iOS 26+, @Observable, NavigationStack, .task {}
forbidden-patterns	No networking, no UIKit, no hardcoded styles, SPM only
design-system	All colors/fonts/spacing via AppTheme tokens
mvvm-architecture	@Observable ViewModels + Loadable<T> for async state
file-structure	150-line target, one type per file, body-as-table-of-contents
components	Button hierarchy, card patterns, empty states, input fields
scope	Build minimum functional app — quality over quantity

---

MCP Server

One server, 12 tools. Pure Python 3 — no pip, no npm, no gems.

Apple Developer Portal

Sign in to Apple Developer directly from your AI tool. Replicates Fastlane Spaceship's SRP-6a + hashcash + 2FA flow.

Tool	Description
status	Live session check — green · yellow · red
login_init	Start SRP-6a sign-in with Apple ID + password
login_2fa	Submit 6-digit 2FA code
request_sms	Send 2FA code via SMS instead
revoke	Sign out and clear session
list_apps	List registered bundle IDs
list_certs	List signing certificates
list_profiles	List provisioning profiles
register_bundle	Register a new bundle ID

RevenueCat

Tool	Description
rc_status	Live API key validation — green · yellow · red
rc_setup	Configure + validate API key and project ID
rc_revoke	Remove stored credentials

---

Security

Credentials are stored locally with chmod 600 permissions and never leave your machine. See SECURITY.md for details.

File	Contents
~/.apple-developer-auth/cookies.txt	Apple session cookies
~/.apple-developer-auth/revenuecat.json	RevenueCat API key

Use revoke / rc_revoke to clear credentials at any time.

---

Credits

Built on top of excellent open-source projects:

	Project	Used for
	asc by @rudrankriyam	App Store Connect CLI
	XcodeGen by @yonaskolb	Xcode project generation
	Fastlane Spaceship	SRP-6a auth flow reference
	RevenueCat	In-app purchase infrastructure
	Agent Skills spec	Universal skill format for AI coding tools
	Model Context Protocol	Universal tool protocol for AI assistants
	Apple Developer Docs	Framework APIs and references

Contributing

Contributions welcome. See CONTRIBUTING.md for guidelines.

License

MIT