RedwindA

Ictrl — Testing skill for Claude Code

Testing community

How to install Ictrl

This entry records only its repository, not the path inside it, so there is no exact command to give. Open RedwindA/ictrl and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Ictrl does

An AI-friendly iOS/iPadOS automation testing tool built on XCUITest, but more than a testing tool: agents like Codex, Claude Code, Hermes, OpenClaw and Minis can operate your iPhone or iPad wirelessly through an encrypted JSON-RPC 2.0 API (tap, type, read the screen, launch apps, and more).

Alternatives in Testing

Playwright — claude-plugins-official Browser automation, E2E testing, screenshots 29.4k ★
OpenAgentsControl — AI agent framework for plan-first development workflows with approval-based execution 4.8k ★
Playwright Automation — git clone Browser automation skill for end-to-end testing and web interaction 2.3k ★

README

iCTRL

**AI-friendly iOS automation service, built on XCUITest.**

[!WARNING] **For automated testing and research only.** iCTRL hands full control of a phone (taps, text input, screen contents, every installed app) to whoever holds a paired key. Any automation like this can be hijacked or misused: a leaked key, a client you shouldn't have approved, or an agent acting on instructions it picked up along the way. **Weigh the risks before you use it:**

Run it only on devices you own and accounts you are entitled to automate.
Approve only the pairing requests you started.
Leave remote access off unless you need it, and stop the server when you are done.
Don't leave an agent unsupervised around payments, messages or anything that can't be undone.

You are responsible for how you use it, including compliance with the terms of the apps you automate.

iCTRL turns an iPhone into a controllable automation endpoint. It runs a long-lived XCUITest runner that exposes a **JSON-RPC 2.0 API over HTTP** (default port `8200`), so an AI agent — or any HTTP client — can drive the device: tap, swipe, type, read the UI tree, take screenshots, launch apps, open URLs, and more.

Unlike a raw XCUITest script, iCTRL is designed to be **discovered and driven by a model**: `GET /skill` serves a complete operating manual and `GET /schema` documents every method with its parameters, so an agent can learn the API at runtime and call it correctly without prior knowledge.

**Works with any agent.** The JSON-RPC API and the skill are built in and progressively discoverable: an agent starts from the manual and drills into the schema only as it needs to. Any agent that can make HTTP requests can use it, such as OpenClaw, Hermes, Minis, Claude Code or Codex. All it needs is the phone's IP address and port; these agents usually explore the endpoint and install the skill themselves to learn how to drive the phone. Minis is additionally optimized for iCTRL, so it