provencher

provencher / xcodemcpcli

Public

CLI for driving Xcode builds, tests, and launches through the Xcode MCP bridge

14
0
100% credibility
Found Apr 11, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A command-line tool that coordinates Xcode builds, tests, and app launches through a shared background process and job queue to prevent conflicts when using multiple AI coding agents.

How It Works

1
🔍 Discover the helper

While working on your Mac app in Xcode, you find this handy tool that makes builds, tests, and launches smoother, especially for teaming up with AI assistants.

2
📥 Get it ready

Download and prepare the tool on your Mac with simple setup steps right from your project folder.

3
⚙️ Link to your app

Tell the tool about your app project and which version to build by running a quick setup command.

4
🔬 Health check

Run a check-up to make sure your project and the tool are perfectly connected and ready to go.

5
🚀 Start the manager

Launch a background helper that handles Xcode permissions once and keeps everything organized.

6
🔨 Build, test, launch

Easily trigger builds, run specific tests, or launch your app – it queues jobs safely so multiple requests don't clash.

✅ Perfect results

Your app builds cleanly, tests pass reliably, launches instantly, and AI helpers work together without issues.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is xcodemcpcli?

xcodemcpcli is a TypeScript CLI for driving Xcode builds, tests, and launches through the Xcode MCP bridge. It runs a persistent daemon to handle one-time permission prompts and a ticketed queue that serializes jobs, letting multiple scripts or agents share an Xcode session without conflicts. Setup is quick with `xcodemcpcli init --scheme MyApp`, then use `build`, `test`, or `launch` commands routed via stdio or HTTP MCP servers.

Why is it gaining traction?

Unlike raw xcodebuild or ad-hoc MCP calls, it prevents repeated Xcode auth popups and race conditions in parallel workflows—ideal for cli driving jobs in GitHub Actions or AI agents like GitHub Copilot. Async mode with `--request-key` and `job status/wait/cancel` lets you enqueue, poll, and retry safely, optimizing compile times. Compact output summarizes issues, warnings, and tests without fluff.

Who should use this?

Xcode devs automating macOS/iOS builds in GitHub Actions on Ubuntu or macOS runners, or scripting cli github clone/test cycles. Teams using GitHub Copilot or other AI for code gen who need reliable MCP bridge access for builds/tests/launches without babysitting Xcode. Suits cli github repo workflows handling Swift packages via cli github com packages.

Verdict

Grab it if you're bridging Xcode to agents or CI—docs and config are polished, tests cover core flows. At 14 stars and 1.0% credibility, it's early but stable for targeted use; watch for broader adoption.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.