Skip to content

callstackincubator/apex-software-factory / .agents/skills/agent-device

agent-device

Verified

Drive the Apex Factory app on a leased iOS simulator or Android emulator with agent-device through .agents/scripts/device-lane.sh — open the app, read the accessibility snapshot, tap, type, scroll, verify with wait/is/get, take screenshots, record evidence, and write or replay agent-device .ad scripts (the e2e tests under apps/mobile/e2e/). Use for any interaction with a device, when writing an e2e: test, or when someone says "check it on the simulator", "tap through the app" or "dogfood the app".

FileKindSize
SKILL.mdskill md7.4 KB
SOURCE.mdmarkdown1.4 KB
references/android-emulator.mdmarkdown1.5 KB
references/dogfood.mdmarkdown933 B
references/ios-simulator.mdmarkdown1.6 KB

references/android-emulator.md

View on GitHub
# Android Emulator

Vendored from upstream `skills/android-emulator/SKILL.md` (see `../SOURCE.md`) and adapted:
in this repo the emulator is leased from simlock and registered with simlock's own adb server.
`.agents/scripts/device-lane.sh lease android` takes it, and `device-lane.sh ad …` adds
`--platform android --serial <leased serial> --session apex-<branch>` and runs agent-device with
simlock's `ANDROID_ADB_SERVER_PORT` in a dedicated state directory. Never install agent-device,
never call `adb` or `emulator` yourself, never `adb kill-server` or `emu kill`.

Android is optional for the booth and less exercised than iOS: if `lease android` or a build
reports `unavailable`, report it and stop.

For a normal app-driving task, start immediately. Do not probe first with `--help`,
`--version`, `devices`, `appstate`, `snapshot`, or `screenshot`:

```bash
.agents/scripts/device-lane.sh ad open com.callstack.apexfactory --foreground
```

Follow the initial interactive snapshot and corrective error hints. Only when the task is
specialized or a command shape is unclear, read the relevant version-matched help topic:

```bash
pnpm exec agent-device help validate        # engineering validation and build freshness
pnpm exec agent-device help debugging       # screenshots, logs, traces, video, and failures
pnpm exec agent-device help react-native    # React Native and Expo runtime guidance
pnpm exec agent-device help scripting       # durable replay and CI workflows
```
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall