list_schemes
Retrieve all available build schemes from an Xcode project or workspace to configure development workflows and testing environments.
Instructions
List all available schemes in an Xcode project or workspace
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectPath | Yes | Path to the Xcode project (.xcodeproj) or workspace (.xcworkspace) |
Implementation Reference
- src/handlers/xcode.ts:18-70 (handler)Handler function that validates the project path, executes xcodebuild -list command, parses the output using parseXcodebuildOutput, and returns formatted scheme list.async listSchemes(args: ListSchemesArgs): Promise<any> { const { projectPath } = args; if (!projectPath) { throw new Error('Project path is required'); } if (!existsSync(projectPath)) { throw new Error(`Project path does not exist: ${projectPath}`); } const stats = statSync(projectPath); if (!stats.isDirectory()) { throw new Error(`Project path is not a directory: ${projectPath}`); } const isWorkspace = projectPath.endsWith('.xcworkspace'); const isProject = projectPath.endsWith('.xcodeproj'); if (!isWorkspace && !isProject) { throw new Error('Project path must be either a .xcworkspace or .xcodeproj file'); } try { const command = isWorkspace ? `xcodebuild -workspace "${projectPath}" -list` : `xcodebuild -project "${projectPath}" -list`; const { stdout, stderr } = await execAsync(command); if (stderr && stderr.trim() !== '') { console.error('xcodebuild stderr:', stderr); } const schemes = this.parseXcodebuildOutput(stdout); return { content: [ { type: "text", text: JSON.stringify({ projectPath, projectType: isWorkspace ? 'workspace' : 'project', schemes, totalSchemes: schemes.length }, null, 2) } ] }; } catch (error: any) { throw new Error(`Failed to list schemes: ${error.message}`); } }
- src/handlers/xcode.ts:72-105 (helper)Private helper method to parse xcodebuild -list output and extract scheme names and shared status.private parseXcodebuildOutput(output: string): SchemeInfo[] { const lines = output.split('\n'); const schemes: SchemeInfo[] = []; let inSchemesSection = false; for (const line of lines) { const trimmedLine = line.trim(); if (trimmedLine === 'Schemes:') { inSchemesSection = true; continue; } if (inSchemesSection) { if (trimmedLine === '' || trimmedLine.startsWith('Build Configurations:') || trimmedLine.startsWith('If no build configuration')) { break; } if (trimmedLine && !trimmedLine.startsWith('Information about project')) { const isShared = !trimmedLine.startsWith(' '); const schemeName = trimmedLine.trim(); if (schemeName) { schemes.push({ name: schemeName, isShared }); } } } } return schemes; }
- src/handlers/xcode.ts:8-10 (schema)TypeScript interface defining the input arguments for listSchemes handler (projectPath: string).export interface ListSchemesArgs { projectPath: string; }
- src/index.ts:836-848 (registration)Tool registration in buildToolsList(): defines name 'list_schemes', description, and inputSchema matching ListSchemesArgs.name: "list_schemes", description: "List all available schemes in an Xcode project or workspace", inputSchema: { type: "object", properties: { projectPath: { type: "string", description: "Path to the Xcode project (.xcodeproj) or workspace (.xcworkspace)" } }, required: ["projectPath"] } },
- src/index.ts:1419-1421 (registration)Dispatch registration in setupHandlers() switch statement: maps 'list_schemes' tool calls to xcodeHandlers.listSchemes.case "list_schemes": return { toolResult: await this.xcodeHandlers.listSchemes(args as any) };