cursorrules

A set of project instructions for AI assistants working on XcodeBuildMCP, a TypeScript server that provides Xcode tools through MCP. Xcode is Apple's development environment for building Mac and iPhone apps, while MCP connects assistants to software tools.

In plain words
What is it for?
Use it when building, checking, formatting, diagnosing, or testing the XcodeBuildMCP project.
Why use it?
It gives the assistant the project's technology choices, supported platforms, and development commands so its work fits the codebase.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/sampsonky/xcodebuildmcp/cursorrules
Clone the repo
git clone --depth 1 https://github.com/SampsonKY/XcodeBuildMCP

Made for: Cursor.

Per session 1,983 This file is loaded in full into every session.
When invoked 1,983 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin fork From a forked repository.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01983 $0.01983
Opus 5 $0.00992 $0.00992
Sonnet 5 $0.00397 $0.00397
Haiku 4.5 $0.00198 $0.00198

Measured yesterday against content hash 9a6918fa7d59, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

cursorrules scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursorrules · 237 lines

How it starts

The opening of the file, as written. The whole thing — 237 lines — stays where its author put it; the contents beside it link to each section on GitHub.

XcodeBuildMCP Rules

You are an AI assistant helping with the XcodeBuildMCP project - a Model Context Protocol (MCP) server that provides Xcode-related tools for AI assistants and MCP clients.

Project Overview

  • Project: XcodeBuildMCP - MCP server for Xcode operations
  • Tech Stack: TypeScript, Node.js (ES modules), MCP SDK
  • Purpose: Standardized interface for AI agents to interact with Xcode projects
  • Target Platforms: macOS, iOS Simulator, iOS Device

Key Technologies & Dependencies

  • Runtime: Node.js 18+ with ES modules (type: "module")
  • Language: TypeScript with strict configuration
  • MCP SDK: @modelcontextprotocol/sdk for protocol implementation
  • Error Monitoring: Sentry for production error tracking
  • External Tools: xcodebuild, AXe (UI automation), iOS Simulator
  • Package Management: npm, supports mise for environment management

Build Commands

  • Build: npm run build
  • Lint: npm run lint
  • Fix lint issues: npm run lint:fix
  • Format code: npm run format
  • Check formatting: npm run format:check
  • Run diagnostics: npm run diagnostic
  • Watch mode for development: npm run build:watch
  • Launch MCP Inspector for testing: npm run inspect

Code Style & Standards

TypeScript Configuration

  • Target: ES2022 with Node16 module resolution
  • Strict type checking enabled
  • Source maps enabled for debugging
  • Output directory: ./build
  • Explicit function return types required
  • No console.log (console.error allowed for MCP logging)
  • Unused variables prefixed with underscore

Code Style Guidelines

  • TypeScript with strict typing enabled
  • ES Modules (import/export) syntax
  • Prefer explicit imports over wildcard imports
  • Group imports: Node.js modules → third-party → local modules
  • Name files in kebab-case, variables/functions in camelCase, classes in PascalCase
  • Prefer async/await over Promises
  • Comment complex logic but avoid redundant comments
  • Error handling should use typed errors from utils/errors.ts

Read the full file on GitHub · 237 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 237 lines · 1,983 tokens per session scan A 9a6918fa7d59

Subscribe to this mod's changes

cursorrules is a cursor rule published in the GitHub repository SampsonKY/XcodeBuildMCP (1 stars, last pushed 1y ago), licensed MIT. It adds 1,983 tokens to every session, about $0.0099 per session on Opus 5. A static security scan graded it A with 0 findings. It comes from a forked repository.