ClaudeCodeMod

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.

In your shell
claude plugin marketplace add breferrari/xcrew
claude plugin install xcrew@breferrari --scope project
Open the repo

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

The author's drawing of the line above the prompt in a terminal titled claude, ~/Developer/MyApp, in four states. While it runs: test_sim, 0:41, a gauge, about 0:24 left, testing 575 of 959, MyApp on iPhone 17. When it passes: test_sim, 1:12 (avg 1:05), 959 passed. When it fails: test_sim, 2:03 (avg 1:58), 3 of 961 failed, PaymentsTests/test_refund(). When a build fails: build_sim, 0:48, CheckoutView.swift:12 Cannot find 'total' in scope. The app, tests and times are the author's samples.
From the author's repo.

What it hooks into

  • tool.callAround a tool call, where it can hold oneBash
  • tool.describeA Claude Code event
  • prompt.submitWhen you send a prompt
  • ui.renderDraws into the sessionAbovePromptPane
  • command.runWhen you run its slash command/xcrew
  • session.startWhen a session starts
  • session.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-start
  • SessionStart"${CLAUDE_PLUGIN_ROOT}/bin/xcrew" hook session-start --late
  • SessionEnd"${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

Other mods in Workflow

commit-medev-build-deployHolds a commandDenies a git commit whose message is not a Conventional Commit, with commit-me's error text and the allowed types and scopes, so Claude rewrites it.noctia-modsEtienneP-26Draws a Noctia band above the prompt, a side panel of subagents, an agent graph, a task checklist, and toasts when a Noctia guard blocks or questions a command.sidecarkaameo-labDocks a pane beside the chat with Claude's options and questions as buttons, a session summary, a diagram of the files it changed, and a log of each turn.android-device-consoleNathanWAHolds a commandDraws a band of live Android device toggles above the prompt and a /device pane for Doze, standby, and WorkManager jobs, and tells Claude the device state.android-logcatNathanWABounds Claude's adb logcat calls, redacts secrets from adb output, and keeps a pid-scoped logcat buffer for a logcat_grep tool and a /logcat pane.android-project-lensNathanWAHolds a commandAsks before Claude adds a permission that needs a Play Console declaration, gives it the real manifest SDKs and permissions, and adds a nav_graph route index.build-output-distillerNathanWASwaps Gradle console output for a short digest of errors and test failures with file:line lists and fix hints, flags a repeat failure, and opens a /build pane.plan-metervumichienDraws a one-line band above the prompt with how far your plan file is, in phases and steps, and how many of Claude's own tasks are done.idea-shelfvumichienParks an idea with /idea while Claude works, counts the shelf in a band, and sends nothing to the model until you press Send.session-monitorvumichienDraws a band of your other Claude Code sessions, how many wait on you, work, or are done, with their own line for sessions in this folder.caffeinezienagReminds the agent of each shell it left running in the background, and toasts when a reminder wakes an idle session.where-am-ihamzaferDraws four things above the prompt: the goal, what is happening now, what is waiting on you, and the next step.
All 396 in Workflow