Skip to content

simx v1.0 — AI-native iOS Simulator automation

Latest
Latest

Choose a tag to compare

View all tags
@doracawl doracawl released this 16 May 04:37
· 537 commits to develop since this release
v1.0.0
bad4ae0

simx is an iOS Simulator automation MCP server, designed for Claude Code subscribers. Tests are written by AI agents; every API choice is graded on "does an AI write correct code on the first try."

Highlights

  • 27 MCP tools — ping + 7 lifecycle + 4 observe + 7 interaction + 3 compound + 4 system + 1 VLM (explain_screen, which shells out to your local claude CLI — no third provider, no API key)
  • DSL shape mirrors Playwright — overwhelming training-data majority, highest 0-shot AI authoring quality
  • Semantic selectors only — text / id / label / role+name + 8 modifiers (near, inside, below, …). No xpath, no coordinates
  • AI-readable failures — ExpectationFailure ships visibleElements + edit-distance suggestions; paste the failure back to a coding agent and it self-corrects
  • Real HID injection — Indigo 9-arg digitizer on iOS 26 (5-arg path for iOS 17/18 lands in v1.0.x); AX read via host-side AccessibilityPlatformTranslation; all private symbols dlsym-loaded, never hard-linked

Verified

`bash scripts/v1-acceptance.sh` returns single-line JSON with 7 Success Criteria + total + all_ok:

# Criterion
[1] AI 0-shot from README "Authoring guide" + MCP server
[2] One-shot self-correct from `ExpectationFailure.toPrompt()`
[3] Cold start `simx run` → first tap < 5s
[4] Single tap < 50ms (iOS 26 main path, 9-arg digitizer)
[5] 100-case serial long-run, no zombie
[6] iOS 17.5 / 18.4 / 26.x runtime matrix
[7] Claude Code plugin one-step install
Baseline Value
TS vitest tests 593 passed (27 test files)
Swift unit tests 102 passed
MCP tools exposed 27
`simx doctor` checks 6, all `supported`
Production deps 3 (`citty`, `@modelcontextprotocol/sdk`, `zod`)

Install

```bash
claude --plugin-dir /absolute/path/to/simx

inside the claude session: /mcp → 27 simx tools

```

Full flow: Plugin install. The 0-shot test-authoring reference: Authoring guide.

Documentation

  • 🌐 https://simx.golia.jp — Quick start / Plugin install / Authoring guide / Tools reference / Examples
  • 📦 README ships the entire Authoring guide so an AI agent with only the README + MCP server connection can 0-shot a working test

What's next

  • v1.0.x — iOS 17/18 5-arg HID real-path implementation (currently softened via CI `continue-on-error`)
  • v1.1 — Watch mode + Cell L4 parallel scheduling + matrix run + Cell L3 TUI status line
  • v2 — Recorder + Vision OCR + Foundation Models + snapshot diff + parasitic Xcode 26 Automation Explorer

License

MIT

Assets 2
Loading