orca-emulator

Control iOS simulators from Orca using the orca CLI for taps, gestures, and typing.

58.7k|4.0k|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/stablyai/orca --skill orca-emulator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orca-emulator
Source: https://github.com/stablyai/orca/tree/main/skills/orca-emulator
Command: npx skills add https://github.com/stablyai/orca --skill orca-emulator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Driving an iOS simulator from an AI agent normally requires juggling raw simctl commands, device scoping, and helper processes by hand. This Skill routes all emulator interaction through the Orca CLI so agents can tap, type, inject camera input, and inspect the accessibility tree while the live device view stays in Orca's emulator pane.

Core Features & Use Cases

  • Full simulator control: Perform taps, gestures, typing, hardware buttons, camera injection, and runtime permission changes through the orca CLI.
  • Version-matched guidance: Load the exact command reference for the installed binary via ORCA skills get orca-emulator, avoiding drift between docs and releases.
  • Safe executable resolution: Pick the correct CLI (orca, orca-dev, orca-ide, or ORCA_CLI_COMMAND) so agents never accidentally launch the GNOME Orca screen reader on Linux.
  • Use Case: An agent testing a mobile app inside Orca resolves the CLI, loads the emulator guide, lists booted devices, then taps through a login flow and reads the accessibility tree to verify the result.

Quick Start

Ask the agent to load the emulator guide with orca skills get orca-emulator and then tap the login button on the booted iOS simulator.

Frequently Asked Questions about orca-emulator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control an iOS simulator from an AI agent?

Use the orca CLI inside Orca: resolve the correct executable, run `orca skills get orca-emulator` to load the version-matched guide, then issue tap, gesture, and typing commands. Prefer --json flags for machine-readable output.

How do I tap and type on an iOS simulator programmatically?

The orca emulator command surface supports taps, gestures, typing, hardware buttons, and camera injection. Load the exact subcommands for your installed version with `orca skills get orca-emulator` rather than guessing flags.

Why does running `orca` on Linux start a screen reader?

On Linux outside Orca-managed terminals, bare `orca` resolves to the GNOME Orca screen reader at /usr/bin/orca. Use `orca-ide` instead, or the value of ORCA_CLI_COMMAND in managed WSL sessions.

Should I use orca CLI or simctl directly for simulator automation?

Prefer the orca CLI when running agents inside Orca, since it handles device scoping, helper lifecycle, and worktree context automatically. Raw simctl or serve-sim lacks that integration and is discouraged in this environment.

What if my Orca version does not recognize `skills get`?

Only when the binary explicitly reports `skills get` as unknown, fall back to `orca status --json` and `orca emulator list --json` for orientation. Then update Orca to restore the full version-matched guide.