xhammer-skill

Claude Code plugin and companion skill for interacting with Xcode projects.

The preferred integration is the xhammer CLI — a standalone tool that communicates with Xcode without triggering a permission dialog on every new session. The Xcode MCP bridge (xcrun mcpbridge) is supported as a manual fallback.

Installation

Option 1: CLI Install (Recommended)

# Install all skills
npx skills add 4rays/xhammer-skill

# Install specific skills
npx skills add 4rays/xhammer-skill --skill xhammer

# List available skills
npx skills add 4rays/xhammer-skill --list

This automatically installs to your .agents/skills/ directory (and symlinks into .claude/skills/ for Claude Code compatibility).

Option 2: Claude Code Plugin

# Add the marketplace
/plugin marketplace add 4rays/xhammer-skill

# Install the plugin
/plugin install xhammer-skill

Or load directly from a local path:

claude --plugin-dir /path/to/xhammer-skill

Option 3: Clone and Copy

git clone https://github.com/4rays/xhammer-skill.git
cp -r xhammer-skill/skills/* .agents/skills/

Option 4: Git Submodule

git submodule add https://github.com/4rays/xhammer-skill.git .agents/xhammer-skill

Option 5: Fork and Customize

1. Fork this repository
2. Customize skills for your needs
3. Clone your fork into your projects

Option 6: SkillKit (Multi-Agent)

npx skillkit install 4rays/xhammer-skill

Quick Start

1. Install xhammer

brew tap 4rays/tap
brew install xhammer

2. Enable Xcode MCP

Open Xcode > Settings (⌘,) → Intelligence → Enable Xcode Tools under Model Context Protocol.

3. Open Your Project

open MyApp.xcodeproj
# or
open MyApp.xcworkspace

4. Ask Claude

Claude will automatically detect xhammer and use it for all Xcode tasks.

Using xhammer

The skill uses the xhammer CLI via the Bash tool. The typical workflow:

# Get a tab ID first
xhammer list-windows

# Then use it in commands
xhammer build windowtab1
xhammer test windowtab1
xhammer build-log windowtab1

Available Commands

Category	Commands
Status	status, stop, restart
Discovery	list-windows, tools, tool-schema, call
Files	read, write, update, ls, glob, grep, mkdir, rm, mv
Build & Test	build, build-log, test, test-list, test-run, issues, refresh-issues
Advanced	exec, preview, docs

Full reference: skills/xhammer/SKILL.md

Xcode MCP Bridge (Alternative)

If you prefer the MCP bridge over xhammer, set it up manually:

claude mcp add --transport stdio xcode -- xcrun mcpbridge

Note: this requires approving a permission dialog in Xcode at the start of every new Claude Code session.

Troubleshooting

• xhammer not found: Install with brew tap 4rays/tap && brew install xhammer
• No tab IDs: Ensure Xcode is running with a project open
• Xcode MCP not enabled: Go to Xcode > Settings > Intelligence > Model Context Protocol
• MCP permission denied: Revoke the process in Xcode Settings and reconnect to retrigger the dialog

Resources

• Apple MCP Documentation

License

MIT