All shelves / Mods / Workflow
xcrew
By breferrari
xcrew is a Claude Code workflow mod by breferrari.
Draws a live line above the prompt for each Xcode build and test, gives Claude only the failures, and asks you before Claude rewrites a generated project file.
DrawsHolds a command
Install
The marketplace name is breferrari.
claude plugin marketplace add breferrari/xcrew claude plugin install xcrew@breferrari --scope project
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.17.1
- License
- MIT
- Repo stars
- 4
- Last change
- 2026-11-04
What it can reach
- Draws in the session
- Holds a command
- Sees tool calls
- Reaches the network or an outside service
- Calls another program on this machine
Needs macOS 26 or later, Xcode 26.3 or later, and Homebrew. Install it at project or local scope: --scope local keeps it to this project, only you. Then run brew install getsentry/xcodebuildmcp/mobilebuildmcp, and on Xcode 27 or later sudo xcrun mcp-server enable. Restart Claude Code in your project and run /xcrew:setup, which builds Xcrew's small Swift CLI in 10 to 20 seconds, once per version. Approve Claude Code in Xcode's dialog the first time Claude calls the Xcode MCP. With the mcs CLI 2026.10.31 or later, mcs pack add breferrari/xcrew --ref stable && mcs sync installs the plugin and MobileBuildMCP and asks which workspace to build.
The marketplace, breferrari, holds only this plugin. Following Xcode builds and tests is why this page files it under workflow. xcode-mods, by artemnovichkov, draws an Xcode band above the prompt and a pane for build, run, and tests, plus a canvas of SwiftUI preview snapshots. xcpane, by griches, turns xcodebuild and swift build output into a live pane of errors grouped by file. This one also starts three MCP servers, MobileBuildMCP, the Xcode MCP, and Sosumi, and tells each session which does what. The line above the prompt shows the elapsed time, a gauge against how long that scheme and test selection usually take, and the phase; when the run ends it shows the outcome compared with recent runs, and after a failing run it ends with /xcrew failures, which opens a pane of every failing test and compile error. Claude reads ~1,000 characters of a failing 961-test run, with each failure's file and line, where it would otherwise get ~80,000. In a Tuist or XcodeGen project it asks before the Xcode MCP's XcodeWrite runs and before an edit to a file a generator writes, and after a manifest edit it refuses the next build once, naming the generate command to run first. Sosumi, the documentation service, receives your documentation searches. In the source, the guards are tool.call hooks in hooks/mod/register.ts.
Demo

What it hooks into
tool.callAround a tool call, where it can hold oneBashtool.describeA Claude Code eventprompt.submitWhen you send a promptui.renderDraws into the sessionAbovePromptPanecommand.runWhen you run its slash command/xcrewsession.startWhen a session startssession.endWhen a session ends
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Hooks 3
SessionStart"${CLAUDE_PLUGIN_ROOT}/bin/xcrew" hook session-startSessionStart"${CLAUDE_PLUGIN_ROOT}/bin/xcrew" hook session-start --lateSessionEnd"${CLAUDE_PLUGIN_ROOT}/bin/xcrew" hook session-end
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- breferrari
- Category
- Workflow
- Marketplace
- breferrari
- Repo
- breferrari/xcrew
- Version
- 0.17.1
- License
- MIT
- Repo stars
- 4
- Last change
- 2026-11-04
- Language
- Swift
- Files
- 502