ios-simulator

Stars12

Forks0

UpdatedApril 8, 2026 at 12:15

This skill MUST be invoked when the user says "simulator", "simülatör", "iOS test", "simulator boot", "simctl", "app launch", "ekran analiz", "screen map", "accessibility audit", "erişilebilirlik", "push notification", "visual diff", "build and test", "xcode build", "simulator oluştur", "simulator sil", "app yükle", or any variation requesting iOS simulator automation, app testing, building, or device management. Provides 21 production scripts for semantic UI navigation, build automation, accessibility testing, and simulator lifecycle management.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

KilimcininKorOglu

KilimcininKorOglu/cli-tweaks

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software Quality Assurance Analysts and TestersComputer and Mathematical Occupations·SOC 15-1253

File Explorer

40 files

SKILL.md

readonly

More from this repository

same repository

check-golang

KilimcininKorOglu/cli-tweaks

This skill MUST be invoked when the user says "check-golang", "govulncheck", "gosec", "cve tara", "cve raporu", "güvenlik açığı tara", "zafiyet tara", "vulnerability scan", "vuln scan", "scan for CVEs", "check vulnerabilities", "güvenlik taraması", "security scan", "static security analysis", "lint tara", "golangci-lint", "modernize", "modernizer", "lint check", "kod kalitesi tara" or any variation requesting a Go security or code-quality scan of the whole project. Runs FOUR tools by default — govulncheck (CVEs), gosec (security static analysis), golangci-lint (lint), and the gopls modernize analyzer — installs any that are missing, scans every package with ./..., classifies each finding, and produces a ranked combined report with fix guidance.

2026-07-2712

version-update-skill-creator

KilimcininKorOglu/cli-tweaks

This skill MUST be invoked when the user says "version update skill oluştur", "create version update skill", "versiyon skill'i oluştur", "update-version skill", "version-update skill yap" or any variation requesting creation of a project-local version update skill. SHOULD also invoke when user mentions "versiyon güncelleme skill'i kur", "setup version bumping", or asks to automate version management for the current project. Scans the project for version files, build commands, and changelog, then generates a tailored version-update skill in .claude/skills/.

2026-07-2712

bug-report

KilimcininKorOglu/cli-tweaks

Use `/bug-report` for full audit, `/bug-report <subcommand>` for focused audits, `/bug-report security-sweep` for security-only scans with a rolling 2-worker pool.

2026-07-2512

commit

KilimcininKorOglu/cli-tweaks

This skill MUST be invoked when the user says "commit", "commitle", "commit at", "commit yap", "push" or any variation requesting a git commit. SHOULD also invoke when user mentions "stage", "staged", "değişiklikleri commitle", or asks to push code changes. Creates well-formatted commits with conventional commit messages. Auto-detects git state, stages changes intelligently, and creates atomic commits with proper type/scope/description format.

2026-07-2512

bug-report

KilimcininKorOglu/cli-tweaks

Use `/bug-report` for full audit, `/bug-report <subcommand>` for focused audits, `/bug-report security-sweep` for security-only scans with a rolling 2-worker pool.

2026-07-2512

git-flow

KilimcininKorOglu/cli-tweaks

This skill MUST be invoked when the user says "git flow", "git-flow", "branch aç", "feature başlat", "feature start", "bugfix", "hotfix", "release branch", "branch oluştur", "create branch" or any variation requesting git branch workflow management. SHOULD also invoke when user mentions "finish branch", "merge feature", "complete hotfix", or asks to follow git-flow branching strategy. Manages git branches following a structured workflow with automatic base branch detection and strict validation rules.

2026-07-1212

name	ios-simulator
description	This skill MUST be invoked when the user says "simulator", "simülatör", "iOS test", "simulator boot", "simctl", "app launch", "ekran analiz", "screen map", "accessibility audit", "erişilebilirlik", "push notification", "visual diff", "build and test", "xcode build", "simulator oluştur", "simulator sil", "app yükle", or any variation requesting iOS simulator automation, app testing, building, or device management. Provides 21 production scripts for semantic UI navigation, build automation, accessibility testing, and simulator lifecycle management.
argument-hint	<script-name> [options]

iOS Simulator Automation

Build, test, and automate iOS applications using accessibility-driven semantic navigation. Find and interact with elements by meaning, not pixel coordinates.

Quick Start

# 1. Check environment
bash scripts/sim_health_check.sh

# 2. Launch app
node scripts/appLauncher.js --launch com.example.app

# 3. Map screen elements
node scripts/screenMapper.js

# 4. Tap button by text
node scripts/navigator.js --find-text "Login" --tap

# 5. Enter text in field
node scripts/navigator.js --find-type TextField --enter-text "user@test.com"

# 6. Check accessibility
node scripts/accessibilityAudit.js

All scripts support --help for options and --json for machine-readable output.

Navigation Priority

Always prefer the accessibility tree over screenshots:

Method	Token Cost	Reliability	Use When
`screenMapper.js`	~10 tokens	High	Default — see what's on screen
`navigator.js --find-*`	~5 tokens	High	Interact with elements
Screenshot	1,600-6,300 tokens	Medium	Visual verification, bug reports, diff only

21 Scripts by Category

Build and Development (2)

Script	Purpose	Key Options
`buildAndTest.js`	Xcode build + test with result parsing	`--project`, `--scheme`, `--clean`, `--test`
`logMonitor.js`	Real-time log monitoring with filtering	`--app`, `--severity`, `--follow`, `--duration`

Navigation and Interaction (5)

Script	Purpose	Key Options
`screenMapper.js`	Analyze current screen, list elements	`--verbose`, `--hints`
`navigator.js`	Find + interact with elements semantically	`--find-text`, `--find-type`, `--find-id`, `--tap`, `--enter-text`
`gesture.js`	Swipes, scrolls, pinches, long press	`--swipe`, `--scroll`, `--pinch`, `--refresh`
`keyboard.js`	Text input + hardware buttons	`--type`, `--key`, `--button`, `--clear`, `--dismiss`
`appLauncher.js`	App lifecycle (launch, terminate, install)	`--launch`, `--terminate`, `--install`, `--open-url`

Testing and Analysis (5)

Script	Purpose	Key Options
`accessibilityAudit.js`	WCAG compliance check	`--verbose`, `--output`
`visualDiff.js`	Screenshot pixel comparison	`--threshold`, `--output`, `--details`
`testRecorder.js`	Auto-document test execution	`--test-name`, `--output`
`appStateCapture.js`	Debugging snapshot (screen + logs + hierarchy)	`--app-bundle-id`, `--output`
`sim_health_check.sh`	Environment verification	(no options)

Permissions and Advanced (4)

Script	Purpose	Key Options
`clipboard.js`	Clipboard management for paste testing	`--copy`, `--expected`
`statusBar.js`	Override status bar appearance	`--preset`, `--time`, `--battery-level`
`pushNotification.js`	Simulated push notifications	`--bundle-id`, `--title`, `--body`, `--payload`
`privacyManager.js`	Grant/revoke app permissions (13 services)	`--bundle-id`, `--grant`, `--revoke`, `--reset`

Device Lifecycle (5)

Script	Purpose	Key Options
`simctlBoot.js`	Boot simulator	`--udid`, `--name`, `--wait-ready`, `--all`, `--type`
`simctlShutdown.js`	Shutdown simulator	`--udid`, `--name`, `--verify`, `--all`
`simctlCreate.js`	Create new simulator	`--device`, `--runtime`, `--name`
`simctlDelete.js`	Delete simulator	`--udid`, `--name`, `--yes`, `--old N`
`simctlErase.js`	Factory reset (preserves UDID)	`--udid`, `--name`, `--verify`, `--booted`

Common Patterns

Auto-UDID: Most scripts auto-detect the booted simulator. No need to specify --udid unless multiple are booted.

Device name: Use names instead of UDIDs: --name "iPhone 16 Pro" — scripts resolve automatically.

Batch operations: --all for all simulators, --type iPhone for device type filtering.

Output modes:

Default: 3-5 lines (token-efficient)
--verbose: full details
--json: machine-readable for CI/CD

Screenshot sizing: half (default, ~1.6K tokens), quarter (~800 tokens), full (~5K tokens). Use quarter for quick checks.

Typical Workflows

Login Flow Test

node scripts/appLauncher.js --launch com.example.app
node scripts/screenMapper.js
node scripts/navigator.js --find-type TextField --index 0 --enter-text "user@test.com"
node scripts/navigator.js --find-type SecureTextField --enter-text "password"
node scripts/navigator.js --find-text "Login" --tap
node scripts/accessibilityAudit.js

Permission Test

node scripts/privacyManager.js --bundle-id com.example.app --grant camera,location
# Test app with permissions...
node scripts/privacyManager.js --bundle-id com.example.app --revoke camera,location

CI/CD Device Lifecycle

DEVICE_ID=$(node scripts/simctlCreate.js --device "iPhone 16 Pro" --json | jq -r '.new_udid')
node scripts/buildAndTest.js --project MyApp.xcodeproj --test
node scripts/simctlDelete.js --udid $DEVICE_ID --yes

Quick Diagnostics

Problem	Solution
Script can't find simulator	Run `sim_health_check.sh` — is any simulator booted?
Navigator can't find element	Run `screenMapper.js --verbose` to see all elements
Build fails with scheme error	Check `--scheme` matches Xcode exactly (case-sensitive)
Permission grant fails	Use exact service names: `camera`, `location`, `photos`, `contacts`
Screenshot too expensive	Use `--screenshot-size quarter` for minimal token cost
IDB commands fail	IDB is optional — install with `brew tap facebook/fb && brew install idb-companion`

Requirements

macOS 12+
Xcode Command Line Tools (xcode-select --install)
Python 3
IDB (optional — brew tap facebook/fb && brew install idb-companion)
Pillow (optional — pip3 install pillow for visualDiff.js)

References

Document	Topic
`references/simctl_quick.md`	simctl command reference
`references/idb_quick.md`	IDB command reference
`references/accessibility_checklist.md`	WCAG compliance checklist
`references/test_patterns.md`	Testing patterns and strategies
`references/troubleshooting.md`	Common issues and fixes

Design Principles

Semantic navigation: Find elements by meaning (text, type, accessibility ID) not pixel coordinates. Survives UI redesigns.

Token efficiency: 96% reduction vs raw tools. Default output is 3-5 lines.

Accessibility-first: Built on iOS accessibility APIs. More reliable than pixel coordinates and better for all users.

Zero configuration: Works immediately on any macOS with Xcode installed.

Structured output: JSON and formatted text, not raw logs. Easy to parse in CI/CD.