Xcode Runner

CLIClaudeCodex

Let your agents run iOS builds and UI tests across multiple projects without slowing down your Mac or interrupting your own work.

Agents wait in line, each with a build, for a free simulator place on a Mac, where two slim simulators run, builds go in a slow lane, and the person's own window stays apart.

The Problem

Multiple agents building and testing across several iOS projects at the same time can put a lot of pressure on your Mac, especially when they all need to run simulators. Each full simulator uses a lot of memory, while background builds compete with the Xcode work you're doing yourself. Before long, everything starts to slow down.

And when the agents finish, they don't always clean up after themselves. Simulators stay running, build files and logs pile up, and it's not always clear which files belong to your agents and which are yours. Cleaning things up can turn into another task, with the risk of accidentally removing something you still need.

The Solution

Xcode Runner provides the guardrails your agents need to perform iOS testing without impacting your system. By using slim simulators and low-priority builds, it ensures that agent activity stays in the background, leaving your CPU and memory free for your own development work.

Features

  • Keep your Mac responsive. Run agent simulators with about half the memory usage of a full simulator, leaving more resources for your own work.
  • Work across multiple projects without overwhelming your Mac. Run several agents in parallel without letting their simulators compete for all your available resources.
  • Keep your own Xcode builds running smoothly. Agent builds stay in the background and separate from your project files, so you can keep working without interference.
  • Finish sessions without the leftover clutter. Agent-created simulators, builds, and logs are cleaned up automatically, while your own files stay untouched.
  • Let agents handle their own troubleshooting. Built-in guidance helps agents resolve common issues, and you can see and remove everything Xcode Runner created if you ever want to uninstall it.

FAQs

Will Xcode Runner affect my own simulators or builds?

No. Your personal simulators and Xcode builds stay separate from agent activity. Agents use their own simulators and build folders, so they won't interfere with your work. You can also choose to make your own simulators slim during setup, but only with your approval.

What happens when multiple agents need a simulator?

Xcode Runner manages access based on the limit you set. Agents wait for a free spot instead of launching too many simulators at once. While waiting, they can continue working on tasks that don't need a simulator.

Does Xcode Runner need an internet connection?

No. Everything runs locally on your Mac. Xcode Runner works entirely offline and doesn't send any data from your machine.

What happens after you buy

  1. 1

    Download

    Click the download link to get the ZIP file. Extract it, then share the folder with your agent.

  2. 2

    Your Agent Guides You Through Setup

    Your agent installs the CLI and plugins. Start a new session and run /xcode-runner setup to finish setup.

  3. 3

    Make it yours

    Make Xcode Runner fit the way you work. Customize simulator limits, cleanup rules, and commands to match your projects and development workflow.

Let your agent check if Xcode Runner is right for you.

Just copy this prompt:

Read https://tools.natashatherobot.com/xcode-runner.md, the page for Xcode Runner. Based on what you know about my projects and workflow, assess whether Xcode Runner would help me run multiple coding agents across iOS projects without slowing down my Mac or getting in the way of my own work. Consider how it could reduce simulator memory usage, keep concurrent builds manageable, and take care of cleanup so I can focus on developing instead of managing agent resources. Explain what I'd gain, whether it would make a meaningful difference to my workflow, and if it's worth the price. If it isn't a good fit, tell me why. Ask me for more context if needed.

It is a starter tool

Xcode Runner is a starter tool you can customize to fit your workflow. You can use, copy, and change it for yourself and your work, across any number of projects. Your AI agents can read, run, and change it for you.

The license is for one person. Each other person who uses Xcode Runner needs their own copy.

You must not share, publish, or sell the tool as it is or with small changes only. The full terms are in the LICENSE file included with your download. The tool comes without warranty.