Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

orca-emulator-android — Claude Code skill: drive Android over adb

Lets the agent drive an adb-connected Android emulator or phone from inside Orca: taps, swipes, APK install, logcat. Handy for running a flow on a real device.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add stablyai/orca --skill orca-emulator-android -a claude-code
Open on GitHub

What orca-emulator-android does

The skill gives the agent control of an adb-connected emulator or phone: booting AVDs, taps, swipes, typing, hardware buttons, rotation, app install and launch, runtime permissions, the accessibility tree and logcat. The live device view sits in Orca's emulator pane. Works on Windows, Linux and macOS.

What ships is a discovery stub. It loads the guide that matches the Orca executable used for the session. Pick that executable once and reuse it for every later command. If ORCA_CLI_COMMAND is set, take its value. In a dev checkout that exposes ORCA_DEV_REPO_ROOT, use orca-dev. On Linux outside an Orca-managed terminal, use orca-ide. Never run bare orca there: it resolves to the GNOME Orca screen reader (/usr/bin/orca) and starts speech on the user's machine. Otherwise, use orca.

Load the guide before running Orca commands: ORCA skills get orca-emulator-android, preferably with --json. If a command says Orca is not running, start it with ORCA open --json and retry. A runtime_access_denied failure means your sandbox blocked the connection: re-run with escalated permissions, and leave ORCA open and Orca itself alone. Build the APK with Gradle first. An iOS simulator needs the separate iOS emulator skill.

What it helps with

  • run a tap-and-swipe flow on an emulator without clicking by hand
  • install an APK and grant runtime permissions from the agent
  • capture logcat while reproducing a bug
  • read the accessibility tree to find an element by its text
  • boot an AVD and set the screen orientation

Example prompts for the agent

  • load the orca-emulator-android guide and boot an AVD
  • install the built APK on the connected emulator and launch the main activity
  • pull logcat from the last minute and show me the errors

How to install orca-emulator-android

1Skills CLI (Vercel)

npx skills add stablyai/orca --skill orca-emulator-android -a claude-code

2Manually: put the files in place

~/.claude/skills/orca-emulator-android/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/orca-emulator-android/

From the same set10

The whole set →
orca-cli stablyai The skill lets an agent manage Orca worktrees, terminals, artifacts and the built-in browser through the orca CLI. Useful when your work already runs inside Orca. Claude Code CX Codex Cursor +1 353,000installs orchestration stablyai Coordinates supervised Orca workers with task DAGs, decision gates, and threaded messages. Fits workflows that split work across multiple agents. Claude Code CX Codex Cursor +1 349,200installs computer-use stablyai This skill drives a visible app window through orca computer: accessibility tree, clicks, typing, screenshots. Reach for it when the job sits behind a GUI. Claude Code CX Codex Cursor +1 239,000installs orca-linear stablyai Manages Linear issues through the Orca CLI directly from agent sessions. Useful for moving tickets between workflow states, linking pull requests, and searching issues. Claude Code CX Codex Cursor +1 29,000installs orca-per-workspace-env stablyai Configures, reviews, and debugs Orca per-workspace environment recipes. Useful when provisioning disposable VMs, containers, SSH hosts, or cloud sandboxes. Claude Code CX Codex Cursor +1 12,100installs orca-emulator stablyai Controls booted iOS Simulators inside Orca with a live device view. Handy for running gestures, hardware buttons, accessibility tree checks, and UI verification. Claude Code CX Codex Cursor +1 5,800installs linear-tickets stablyai This skill runs Linear ticket work through Orca's CLI: read a linked issue, move it through workflow states, close it with a PR link and a comment. Claude Code CX Codex Cursor +1 4,500installs orca-jira stablyai This skill handles Jira work through Orca CLI: JQL search, workflow transitions, completion comments with PR or MR links, and follow-up issues. Claude Code CX Codex Cursor +1 580installs

Similar

aso coreyhaines31 Audits App Store and Google Play listings against store optimization standards. Helps uncover gaps in metadata, visual assets, and conversion. Claude Code CX Codex Cursor +1 74,900installs swiftui-pro Paul Hudson Reviews SwiftUI code for deprecated APIs, data-flow issues, accessibility gaps, and performance concerns. Use it during feature work or code review. Claude Code CX Codex Cursor +1 35,000installs imsg openclaw Connects AI coding agents to the imsg CLI to read chat history, send iMessage and SMS texts, and manage reactions or polls. Claude Code CX Codex Cursor +1 3,400installs app-store-screenshots ParthJadhav Scaffolds a Next.js and ShadCN editor where you design and export App Store and Google Play screenshots. Claude Code CX Codex Cursor +1 14,900installs liquid-glass-design affaan-m A skill that feeds your coding agent the iOS 26 Liquid Glass patterns for SwiftUI, UIKit and WidgetKit. Useful when you're building or porting an app to iOS 26+. Claude Code CX Codex Cursor +1 5,200installs vercel-react-native-skills vercel A rules pack for React Native and Expo work: lists, animations, navigation, native modules. Load it so your agent makes mobile changes the same way every time. Claude Code CX Codex Cursor +1 253,900installs animate-expo emilkowalski Builds React Native and Expo animations using Reanimated and Gesture Handler. Helps keep motion on the UI thread and avoid dropped frames on physical devices. Claude Code CX Codex Cursor +1 135,900installs mobile-native emilkowalski Strips the tells that give a web app away on a phone: sticky hover, tap highlight flash, the 100vh bug. Claude Code CX Codex Cursor +1 84,500installs

Questions about orca-emulator-android

How do I install orca-emulator-android in Claude?

Run npx skills add stablyai/orca --skill orca-emulator-android -a claude-code. The skill file lands at ~/.claude/skills/orca-emulator-android/SKILL.md.

What does orca-emulator-android do?

It drives an Android device or emulator over adb from Orca: taps, swipes, typing, buttons, rotation, app install and launch, permissions, the accessibility tree, logcat. The device view shows up in Orca's emulator pane.

What do I need before running it?

Build the APK with Gradle and resolve the Orca executable for the session. On Linux outside an Orca terminal that is orca-ide, because bare orca starts the GNOME screen reader.

Source text

SKILL.md · Apache-2.0
---
name: orca-emulator-android
description: >-
  Android device and emulator control from inside Orca over adb, with the live
  device view in Orca's emulator pane. Use when driving an adb-connected emulator
  or phone on Windows, Linux, or macOS: booting AVDs, taps, swipes, typing,
  hardware buttons, rotation, app install and launch, runtime permissions, the
  accessibility tree, and logcat. For an iOS simulator use the iOS emulator
  skill; build the APK with Gradle first.
license: Apache-2.0
---

# Orca Emulator (Android)

This discovery stub loads the version-matched guide from the Orca executable used for this session.

## Resolve the CLI for this session

Choose the executable once and reuse it for every later command:

- If the `ORCA_CLI_COMMAND` environment variable is set, use its value. Orca exports this
  for managed WSL sessions.
- Otherwise, in a dev checkout whose session exposes `ORCA_DEV_REPO_ROOT`, use `orca-dev`.
- Otherwise, on Linux outside an Orca-managed terminal, use `orca-ide`. Never run bare
  `orca` there — outside Orca's terminals it normally resolves to the
  GNOME Orca screen reader (`/usr/bin/orca`) and starts speech on the user's machine.
- Otherwise, use `orca`.

Below, `ORCA` is a placeholder for the executable you resolved. Substitute it before
running anything; do not create a shell variable or run `ORCA` literally. This works the
same way in POSIX shells, PowerShell, and cmd.exe.

If the selected executable cannot run, report its exact error and stop. Do not fall through
to another executable, which could silently target a different Orca build.

## Load the version-matched guide before running Orca commands

```text
ORCA skills get orca-emulator-android
```

Prefer `--json`. Use the selected executable's `--help` for commands or flags the guide does
not cover. If a command reports that Orca is not running, start it with `ORCA open --json`
and retry. If it fails with `runtime_access_denied`, your sandbox blocked the connection:
re-run it with escalated permissions, and do not run `ORCA open` or restart Orca. If
`skills get` is unknown, explain that updating Orca restores the guide; use `--help` for
read-only discovery and do not guess unsupported commands.

© stablyai · Apache-2.0 · stablyai/orca

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor