Tools overview
Prerequisites and tooling for agentic Apple development with this foundation.
Pick the tool page for the job. Skills still own what to build; these pages own how agents drive Xcode, Maestro, and foundation scripts.
I need to…
| Need | Go to |
|---|---|
| Build, test, simulator, device, UI inspect | XcodeBuildMCP · session order in MCP.md |
| UI regression / flaky flow diagnosis | Maestro · $maestro-apple-app-testing |
| Install or verify foundation skills | Scripts · Quickstart |
| Scenario → tools → verify | Task recipes |
| Unblock a failure | Troubleshooting |
Required for app work
| Tool | Role |
|---|---|
| Xcode | Compile, sign, simulators, Instruments |
| XcodeBuildMCP | Primary agent-facing build, test, simulator, and UI-inspection interface |
| Codex | Supported and verified host for the repository’s installer and skill invocation contract |
| Swift 6 toolchain (via Xcode) | Language baseline for skills |
Other hosts are manual compatibility targets only when their authoritative documentation confirms compatible skill discovery and MCP support. See Agent host support.
Strongly recommended
| Tool | Role |
|---|---|
| Maestro (+ MCP if available) | Declarative UI flows and regression |
| This repo’s install/verify scripts | Skill distribution integrity |
Optional (this docs site only)
| Tool | Role |
|---|---|
| Node.js 22.12+ | Run Blume (npm run dev / build) |
| npm | Root package for Blume |
Deep dives
Source files in the repo
| File | Contents |
|---|---|
MCP.md |
MCP install notes, session workflow, prompts |
AGENTS.md |
Always-on agent rules |
.agents/skills/ |
Skill source |
Scripts/ |
install / verify / test helpers |