This repository provides a comprehensive guide for setting up and utilizing the Claude Code CLI tailored for Swift/SwiftUI iOS development. It addresses the need for structured, AI-assisted development workflows by integrating advanced AI planning capabilities (like Ultrathink and Plan Mode) with direct access to the iOS build system via XcodeBuildMCP. The target audience is technically savvy iOS developers seeking to enhance productivity, enforce best practices, and leverage AI for complex tasks ranging from architectural decisions to debugging and implementation.

How It Works

The core approach centers on the Claude Code CLI, which acts as an AI development assistant. It enforces a Product Requirements Document (PRD)-driven workflow, using Markdown files (CLAUDE.md, docs/PRD.md, docs/specs/, docs/tasks/) to define project context and development stages. Crucially, it integrates with XcodeBuildMCP via stdio transport for all Xcode operations (build, test, clean), enabling AI-driven automation of the iOS development lifecycle. Advanced AI features like "Ultrathink" and "Plan Mode" facilitate deep analysis and strategic planning before code modification.

Quick Start & Requirements

• Installation:
  • Native (Recommended): curl -fsSL https://claude.ai/install.sh | bash
  • NPM (Alternative): npm install -g @anthropic-ai/claude-code
• Authentication: Run claude and authenticate via OAuth, or set the ANTHAOPIC_API_KEY environment variable.
• Model Selection: Use the --model flag (e.g., claude --model claude-opus-4-5-20250929) or set the ANTHROPIC_MODEL environment variable.
• Prerequisites: macOS/Linux, curl, Node.js (for NPM install), Xcode, Swift 6.0+, iOS 17+.
• Links: Installation script URL: https://claude.ai/install.sh.

Highlighted Details

• PRD-Driven Workflow: Enforces a structured development lifecycle (PRD -> Spec -> Tasks) using Markdown files and CLAUDE.md for project context.
• Advanced AI Reasoning: Features "Ultrathink" and "Plan Mode" for deep architectural analysis, complex debugging, and multi-step implementation planning in a read-only environment.
• XcodeBuildMCP Integration: Seamlessly automates Xcode builds, tests, and simulator operations via stdio transport for direct AI interaction with the iOS build system.
• Extensibility: Supports custom slash commands, project-specific agent skills, and specialized subagents (e.g., ios-architect, swift-reviewer) for tailored workflows.
• Sandbox Mode & Hooks: Offers granular permission controls for safe development and automated execution of tasks (linting, file protection) via shell script hooks.

Maintenance & Community

No specific information regarding maintainers, community channels (like Discord/Slack), or roadmap is provided within the README.

Licensing & Compatibility

The README does not specify a software license. Compatibility for commercial use or closed-source linking is therefore undetermined.

Limitations & Caveats

The README does not explicitly detail limitations, alpha status, or known bugs. The effectiveness is contingent on prompt quality and LLM capabilities. Setup requires XcodeBuildMCP and API key management. Cost implications for extensive AI reasoning modes are noted but not precisely quantified.