AppleDocsTool

Apple development tools for Claude Code and Cursor - simulator UI automation, project analysis, build/test, and documentation lookup.

Install

Claude Code Plugin

From GitHub (works now):

/plugin marketplace add briannadoubt/claude-marketplace
/plugin install apple-docs@briannadoubt

From official marketplace (after approval):

/plugin install apple-docs

Alternative: Local Claude install

git clone https://github.com/briannadoubt/AppleDocsTool.git
claude plugin install ./AppleDocsTool --scope user

Or MCP-only (no skills):

cd AppleDocsTool && swift build -c release
claude mcp add apple-docs .build/release/apple-docs

Verify Claude install:

/plugin list    # should show apple-docs

Cursor MCP

Cursor project-level MCP config is included at .cursor/mcp.json.

git clone https://github.com/briannadoubt/AppleDocsTool.git
cd AppleDocsTool
swift build

Then in Cursor, open this repository and enable the apple-docs (minimal) or apple-docs-full server from MCP settings.

Cursor skills/rules are included at .cursor/rules/apple-docs-skills.mdc and route tasks to the shell-first workflows in skills/.

Architecture

This tool uses a skills-first approach for efficiency:

Layer	What	Token Cost
Skills	Shell commands in `skills/` directory	~0 (just file reads)
MCP (minimal)	3 UI automation tools	~2K tokens
MCP (full)	All 33 tools	~30K tokens

By default, the server exposes only 3 tools that require macOS Accessibility APIs. Everything else can be done with shell commands documented in the skills.

Skills

Claude and Cursor agents discover capabilities from skills/SKILLS.md:

Skill	Description	Example Commands
analyze-project	Understand project structure	`cat Package.swift`, `grep -rn "struct"`
build-and-test	Build and test	`swift build`, `swift test`
lookup-docs	Find documentation	Apple docs URLs, GitHub READMEs
control-simulator	Manage simulators	`xcrun simctl boot`, `xcrun simctl install`
profile-app	Profile performance	`xcrun xctrace record`
ui-interact	UI automation	Requires MCP tools

MCP Tools

Default (Minimal Server)

Only tools that can't be done with shell commands:

Tool	Description
`simulator_ui_state`	Get screenshot + OCR text with tap coordinates
`simulator_interact`	Tap, swipe, type text, press hardware buttons
`simulator_find_text`	Find text on screen, get coordinates

Full Server

For all 33 tools (project symbols, Apple docs, build/test, profiling, etc.):

# Claude: configure with --full flag
claude mcp add apple-docs ~/.mint/bin/apple-docs --args --full

Full tool list

Project Analysis

get_project_symbols - Extract types, functions, properties
get_project_dependencies - List dependencies with versions
get_symbol_documentation - Detailed docs for specific symbols
get_project_summary - Quick project overview
search_symbols - Fuzzy search across project and Apple frameworks

Documentation

lookup_apple_api - Apple framework documentation
get_dependency_docs - Fetch README from GitHub

Build & Test

swift_build - Build Swift packages
swift_test - Run tests with structured output
swift_run - Run executables
xcodebuild_build - Build Xcode projects
xcodebuild_test - Run Xcode tests
list_schemes - List available schemes
list_destinations - List simulators/devices

Profiling

instruments_profile - Profile with any Instruments template
list_instruments_templates - List available templates

Simulator Control

simctl_list_devices - List simulators
simctl_list_runtimes - List iOS/tvOS/watchOS versions
simctl_device_control - Boot, shutdown, create, delete
simctl_app_install - Install apps
simctl_app_control - Launch, terminate, uninstall
simctl_app_info - Get app info
simctl_screenshot - Capture screenshots
simctl_record_video - Record video
simctl_location - Set GPS location
simctl_push - Send push notifications
simctl_privacy - Manage permissions
simctl_status_bar - Override status bar
simctl_pasteboard - Clipboard access
simctl_open_url - Open URLs/deep links

UI Automation

simulator_ui_state - Screenshot + OCR
simulator_interact - Tap, swipe, type, buttons
simulator_find_text - Find text coordinates

apple-docs

Popularity

What's Inside

README

AppleDocsTool

Install

Claude Code Plugin

Cursor MCP

Architecture

Skills

MCP Tools

Default (Minimal Server)

Full Server

Usage Examples

With Skills (Recommended)

Confidence

Similar Plugins

Build Swift Apps

xclaude-plugin

xcode-build-skill

app

swiftui-autotest-skill

swift-engineer

More by briannadoubt

trust

trebuchet