Edit anywhere
Codex, your terminal, or the editor that keeps you in flow.
RunnerKitXcode build and run from your menu bar or CLI
Run Xcode projectsfrom anywhere.
Stay in your editor, terminal, or coding agent. RunnerKit remembers how your Apple project runs, then lets Xcode do what it does best.
7-day full trialNo account or payment required
Native macOS app Xcode-aware Agent-ready CLI Operation history
The bridge
Keep your tools. Get the Run workflow.
RunnerKit turns the choices scattered across Xcode into a small, reusable contract between your code and the device it belongs on.
Recall the run
One saved configuration holds every Xcode decision.
Build & launch
Xcode builds. RunnerKit installs, launches, observes, and stops.
Two ways inMade for your click.
Made for your click.
Built for their command.
RunnerKit keeps one source of truth whether the next run starts from your menu bar or from an agent working through the CLI.
01For you
A tiny control room in your menu bar.
Left-click to run or stop. Right-click to switch the active target, configure it, inspect the last build log, jump into Xcode, or force a stuck operation to stop.
02For agents
A CLI that reports more than “done.”
Start runs, wait for precise milestones, retrieve operation-scoped logs, and diagnose failures without guessing what the GUI is doing.
runnerkit · zsh⌘K
$ runnerkit run "RunnerKit — My Mac" \\
--until running --timeout 120
operation 8F12 accepted
✓ prepared 0.3s
✓ built 4.8s
✓ running pid 48211
$
Agent-native, not agent-exclusive
One app owns the truth.
The menu-bar app remains the single owner of configurations, builds, launched applications, and logs. The bundled CLI simply gives your agent a precise, version-matched way to ask—and one switch can reject new command requests without stopping work already underway.
- 01Permission stays visibleAllow or reject new same-user CLI and agent requests from Settings.
- 02Speaks structured JSONMachine-readable output without losing human clarity.
- 03Waits for real milestonesAccepted, built, running, or exited—not arbitrary sleeps.
Quietly capableThe details stay out of your way.
The details stay out of your way.
Until you need them.
01
Remember every run
Save Xcode, project, scheme, destination, configuration, arguments, and environment as one named setup.
02
Run every Apple target
Launch macOS apps, simulators, and compatible physical devices through the toolchain already on your Mac.
03
Know what happened
Keep structured stage outcomes, durations, process identifiers, diagnostics, and retained logs for every operation.
04
Leave Xcode untouched
RunnerKit selects each toolchain per run with DEVELOPER_DIR. Your global xcode-select setting stays exactly as it was.
05
Fit the way you work
Keep the menu-bar control, add an optional Dock presence, record global shortcuts, and decide when build progress appears.
06
Trust before you build
Interactive runs ask before executing an unfamiliar project, keeping the code-execution boundary visible.
RunnerKit explained
Xcode build and run, without the context switch.
The essentials for developers and coding agents evaluating a repeatable Apple-platform run workflow.
What is RunnerKit?
RunnerKit is a native macOS menu-bar app that saves the Xcode choices required to build and run an Apple project. It gives developers, terminal users, and coding agents a repeatable Run workflow outside Xcode.
Does RunnerKit replace Xcode?
No. RunnerKit uses the complete Xcode installation already on your Mac. It selects the toolchain for each run, asks Xcode to build, and then handles installation, launch, observation, and stopping without changing your global xcode-select setting.
Which projects and destinations can RunnerKit run?
RunnerKit works with discoverable Xcode projects and workspaces. It can launch macOS apps, Apple-platform simulators, and compatible physical devices reported by the selected Xcode installation. Swift Package Manager-only projects are not supported in v1.
How does RunnerKit work with coding agents?
Its bundled, version-matched CLI can start builds and runs, wait for real milestones, return structured JSON, inspect operation-scoped logs, and diagnose failures. The menu-bar app remains the single owner of configurations and running processes.
What does RunnerKit require?
RunnerKit requires an Apple silicon Mac running macOS 26 or newer and a complete Xcode installation with the SDKs and runtimes needed by your project.
How do the trial and license work?
The full-featured trial lasts 7 days and starts only when you choose, with no account or payment method required. Unlocking RunnerKit costs $9.99. Configurations, settings, logs, purchase, and activation remain available without access; starting a build or run requires an active trial or license.
View individual and team pricingCan RunnerKit live in the Dock too?
Yes. The menu-bar control is always present, while Dock presence is optional. Dock mode adds the standard app menus, a RunnerKit Dock menu, and reopen behavior that brings the configuration window forward.
Is RunnerKit safe to use with unfamiliar projects?
Building an Xcode project can execute scripts, package plugins, and macros. Interactive RunnerKit runs ask you to confirm unfamiliar projects. CLI runs intentionally bypass that prompt, so agents should only receive configurations for code you trust to execute.
Your next run is one action awayClose the gap between
writing and running.
RunnerKit is available for direct distribution on macOS.