xcode-mods
Xcode's build, tests, console and SwiftUI previews inside Claude Code.
Illustration. Actual results depend on the mod, terminal and environment.
Install
/plugin marketplace add artemnovichkov/xcode-mods
/plugin install xcode-mods@xcode-mods
/reload-pluginsRun these commands one at a time in a Claude Code session.
claude plugin marketplace add artemnovichkov/xcode-mods
claude plugin install xcode-mods@xcode-modsThen run /reload-plugins in your session, or start a new session.
Please install the Claude Code mod "xcode-mods" (https://github.com/artemnovichkov/xcode-mods). Before installing, read the Security and Requirements sections of its README and tell me what it reads and writes, which commands it runs, whether it uses the network, and which Claude Code version, OS and terminal it needs. If everything looks fine, run claude plugin marketplace add artemnovichkov/xcode-mods and claude plugin install xcode-mods@xcode-mods, then remind me to run /reload-plugins in my session.Send this to Claude Code so it reads the author’s instructions before installing.
git clone https://github.com/artemnovichkov/xcode-mods
cd xcode-mods
claude --plugin-dir ./mods/xcode-modsClone the repository and try it in a local session with --plugin-dir.
What it accesses
Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.
Reads
YesReads Xcode projects, Swift files, test lists and preview images in the working folder.
Writes files
YesWrites downscaled preview JPEGs via sips.
Runs commands
YesRuns find, grep, sips, xed and open, and calls the xcode MCP server.
Network
UnspecifiedIntroduction
xcode-mods is a Claude Code mod built on Xcode 27's headless Xcode MCP server (the mod itself is not an MCP). It adds a toolbar band (scheme ▸ destination, activity, problem counters), an Xcode pane with Build · Run · Tests tabs (live build progress and issues, grouped tests, stdout and OSLog), and a Canvas pane with SwiftUI #Preview snapshots that re-render after Claude edits Swift files. Toasts report results, and x sends issues to Claude to fix. It also reflects Claude's own Xcode tool calls, and stays hidden outside folders with an .xcodeproj/.xcworkspace. Needs Xcode 27+ with headless MCP enabled, an MCP server named xcode, and an mcp__xcode allow rule; the author states Claude Code 2.1.286+ (before our 2.1.287 baseline). Terminal previews need the kitty graphics protocol. Based on README and source; not run-tested by us.
Who it is for
- People building iOS or macOS apps with Claude Code
Requirements
- Claude Code ≥ 2.1.286
- Platforms · macOS
- Needs Xcode 27+ with the headless MCP server enabled.
- Add an MCP server named xcode and allow mcp__xcode.
- Terminal previews need the kitty graphics protocol, e.g. Ghostty.