orca-emulator
Orca Emulator (serve-sim powered)
Drive an Apple Simulator (iOS / iPad / Watch) from within Orca using ORCA emulator ... commands (or ORCA emulator exec for raw power). This wraps the excellent serve-sim open-source tool so agents get a consistent Orca-native CLI surface, automatic helper management, and seamless integration with Orca's live emulator pane (the visual "preview" surface).
The underlying serve-sim helper captures the real simulator framebuffer (via private SimulatorKit / IOSurface for low-latency 60fps H.264 or MJPEG) and exposes a WebSocket control channel. Orca's bridge owns the helper processes and per-worktree "active emulator" state so unqualified commands "just work" on whatever device/pane is current for the worktree.
CLI executable
Choose the Orca executable once: use the ORCA_CLI_COMMAND environment value when set;
otherwise use orca-dev in a dev session exposing ORCA_DEV_REPO_ROOT, orca-ide on
Linux outside an Orca-managed terminal, and orca everywhere else. Never try bare
orca first on unmanaged Linux because it normally resolves to the GNOME screen reader.
In every command example — fenced blocks, tables, and prose — ORCA is a documentation
placeholder. Replace it with the chosen executable before running the command; do not
create a shell variable or run ORCA literally. The command examples are intentionally
shell-neutral for POSIX shells, PowerShell, and cmd.exe.