simctl-health-check
Performs a complete diagnostic check of your iOS development environment, validating Xcode tools, simulators, runtimes, and disk space, returning actionable recommendations for any issues found.
Instructions
simctl-health-check
Comprehensive iOS simulator environment health check.
Overview
Performs a complete diagnostic check of your iOS development environment, validating Xcode tools, simulators, runtimes, and disk space. Returns actionable recommendations for any issues found. Checks 6 critical areas in seconds: Xcode Command Line Tools, simctl availability, available simulators, booted simulators, available runtimes, and disk space.
Parameters
None - performs complete environment check automatically.
Returns
Health report with pass/fail status for each check, specific guidance for failures, summary of passed/failed checks, and overall healthy status indicator.
Examples
Run complete health check
await simctlHealthCheckTool();Check before CI/CD pipeline
// Validate environment before running test suite
const health = await simctlHealthCheckTool();
if (!health.healthy) {
console.error('Environment issues detected');
}Related Tools
simctl-list: See available simulators after health check passes
simctl-create: Create simulators if none found
simctl-suggest: Get intelligent simulator recommendations
Notes
Checks 6 critical areas: Xcode tools, simctl, simulators, booted devices, runtimes, disk space
Provides specific solutions for each failed check
Validates entire toolchain in seconds
Warns if disk usage over 80% (simulators require significant space)
Perfect for troubleshooting when operations fail unexpectedly
Use before CI/CD pipeline execution to ensure environment health
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||