Claude-code-toolkit xcode-makefiles

Install strict Xcode Makefile tooling for iOS/macOS projects, including build/run/test scripts with AGENT_NAME-based per-agent isolation under build/. Use when a project needs reproducible local CLI builds without full app scaffolding.

install
source · Clone the upstream repo
git clone https://github.com/robertguss/claude-code-toolkit
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/robertguss/claude-code-toolkit "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/mobile-app-dev/ios-mac-app-creator/xcode-makefiles" ~/.claude/skills/robertguss-claude-code-toolkit-xcode-makefiles && rm -rf "$T"
manifest: skills/mobile-app-dev/ios-mac-app-creator/xcode-makefiles/SKILL.md
source content

Xcode Makefiles

Overview

Paul Solt Paul@SuperEasyApps.com Version: 0.9.8

Install a focused Makefile + scripts toolkit into an existing or newly scaffolded Xcode project.

Canonical conventions:

  • AGENT_NAME
    is the only agent env var.
  • Per-agent paths live under
    build/
    :
    • build/DerivedData/<AGENT_NAME>
    • build/logs/<AGENT_NAME>
    • build/cache/<AGENT_NAME>
    • build/tmp/<AGENT_NAME>

Install

skills/xcode-makefiles/scripts/install.sh \
  --project-dir /path/to/project \
  --app-name WalkTrack \
  --platform ios

Common flags:

  • --project-dir PATH
    required
  • --mode install|upgrade
    default
    install
  • --dry-run
    preview changes only

Toolkit flags:

  • --app-name NAME
    required
  • --platform ios|macos
    required
  • --sim-name NAME
    optional, defaults to
    auto
    for iOS
  • --namespace NAME
    optional, installs
    Makefile.NAME
    and
    scripts/NAME/

Installed scripts include:

  • scripts/atomic_commit.sh
  • scripts/xcbuild.sh
  • scripts/resolve_agent_name.sh
  • scripts/resolve_sim_destination.sh
  • scripts/diagnose.sh
  • scripts/run_app_macos.sh
  • scripts/run_app_ios_sim.sh
  • scripts/clean.sh
  • scripts/move_to_trash.sh

Targets

Installed Make targets are intentionally minimal:

  • make diagnose
  • make build
  • make test
  • make run
  • make build-and-run
  • make build-and-run-background
  • make clean
  • make agent-verify