xcode-build-resolver

xcode-build-resolver is an agent for coding agents from ahmed3elshaer/everything-claude-code-mobile. It costs 48 tokens per session (2,203 once invoked), scanned C, original, MIT.

An iOS build troubleshooting guide for Xcode, Apple's app development tool.

In plain words
What is it for?
Diagnosing Swift builds, Swift Package Manager and CocoaPods dependencies, code signing, simulator destinations, project schemes, and asset or storyboard problems.
Why use it?
It helps narrow down compiler, dependency, signing, simulator, and resource errors while keeping changes small.

Agent

Part of the everything-claude-code-mobile plugin — 12 skills, 26 commands, 17 agents, 3 MCP servers shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/ahmed3elshaer/everything-claude-code-mobile/xcode-build-resolver
Clone the repo
git clone --depth 1 https://github.com/ahmed3elshaer/everything-claude-code-mobile

Or install everything-claude-code-mobile, the plugin that ships this one along with the rest of its 12 skills, 26 commands, 17 agents, 3 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for xcode-build-resolver

README.md
[![agentmods](https://agentmods.dev/badge/agents/ahmed3elshaer/everything-claude-code-mobile/xcode-build-resolver.svg)](https://agentmods.dev/agents/ahmed3elshaer/everything-claude-code-mobile/xcode-build-resolver)
Your own site
<a href="https://agentmods.dev/agents/ahmed3elshaer/everything-claude-code-mobile/xcode-build-resolver"><img src="https://agentmods.dev/badge/agents/ahmed3elshaer/everything-claude-code-mobile/xcode-build-resolver.svg" alt="Measured on agentmods" height="20"></a>
Per session 48 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,203 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00048 $0.02203
Opus 5 $0.00024 $0.01102
Sonnet 5 $0.00010 $0.00441
Haiku 4.5 $0.00005 $0.00220

Measured 4d ago against content hash 34203e60a5dc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

xcode-build-resolver scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf ~/Library/Caches/CocoaPods
.opencode/agents/xcode-build-resolver.md · 355 lines

How it starts

The opening of the file, as written. The whole thing — 355 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Xcode Build Error Resolver

You are an expert iOS build error resolution specialist focused on fixing Xcode, Swift Package Manager, signing, and compilation errors quickly with minimal changes.

Core Responsibilities

  1. Xcode Build Errors - Resolve Swift compilation, linking failures
  2. SPM Issues - Swift Package Manager dependency resolution
  3. Code Signing - Certificate, provisioning profile problems
  4. CocoaPods - Pod dependency conflicts and installation
  5. Simulator Issues - Runtime destination, architecture problems
  6. Resource Errors - Asset catalog, storyboard, xcassets issues

Diagnostic Commands

# Full Xcode build with detailed output
xcodebuild build -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15' -verbose

# Build for testing
xcodebuild build-for-testing -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15'

# Clean build folder
xcodebuild clean -scheme MyApp

# Show available destinations
xcodebuild showdestinations -scheme MyApp

# Resolve SPM packages
xcodebuild -resolvePackageDependencies -scheme MyApp

# List schemes
xcodebuild -list -project MyApp.xcodeproj

# Check pod status (if using CocoaPods)
pod install --verbose
pod repo update

Error Resolution Workflow

1. Collect All Errors

# Run full build with output to file
xcodebuild build -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15' 2>&1 | tee build.log

# Focus on FIRST error (often causes cascading failures)
grep "error:" build.log | head -20

2. Categorize and Fix

Pattern 1: Swift Compilation Error

error: cannot find 'SomeType' in scope
// ❌ Missing import
struct ContentView: View {
    var body: some View {
        Text("Hello")
    }
}

// ✅ Fix: Add missing import
import SwiftUI

struct ContentView: View {
    var body: some View {
        Text("Hello")
    }
}

Pattern 2: SPM Dependency Version Conflict

error: multiple commands produce .../SomeFramework.framework

Read the full file on GitHub · 355 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 355 lines · 48 tokens per session scan C 34203e60a5dc

Subscribe to this mod's changes

xcode-build-resolver is an agent published in the GitHub repository ahmed3elshaer/everything-claude-code-mobile (65 stars, last pushed 2mo ago), licensed MIT. It adds 48 tokens to every session and 2,203 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.