xcode-mcli
v0.1.1
Published
One-to-one CLI for Apple's Xcode MCP bridge.
Downloads
22
Readme
xcode-mcli
xcode-mcli is a macOS CLI for Apple's Xcode MCP bridge exposed through xcrun mcpbridge.
It gives you a daemon-backed terminal interface to the current Xcode MCP tool surface without registering Xcode MCP inside Codex or another MCP client.
Requirements
- macOS
- Xcode with
Xcode Toolsenabled inSettings > Intelligence - Node.js 25+
Install
npm installFor a global install:
npm install -g xcode-mcliQuick Start
xcode-mcli setup
xcode-mcli windows list
xcode-mcli windows use --tab-identifier windowtab1
xcode-mcli files read --tab-identifier windowtab1 --file-path Path/To/File.swift
xcode-mcli project build --tab-identifier windowtab1The daemon auto-starts on the first daemon-backed command.
Output Modes
- Default output is concise text.
--jsonprints a stable wrapper envelope.--verboseprints the exact Xcode MCP tool name tostderrfor tool-backed commands.
Example:
xcode-mcli --json --verbose windows list--json, --verbose, and --tab-identifier <id> can be passed either before the command path or after the specific command.
Command Groups
setupdaemonwindowsprojectdocssnippetbuildissuestestspreviewfiles
Docs
Compatibility
Pin and verify the Xcode MCP surface with:
npm run compat:xcode-mcp:verifyThe pinned Apple Xcode 26.3 baseline lives at:
skill/references/apple-xcode-26.3.surface.jsonDevelopment
npm test
make lint
make verify