android-uselisted
Install: claude install-skill ramus-dev/android-use
# Android-use with Ramus
`ramus` (or `npx ramus-cli`, Node.js 22+) gives you a disposable Android
device. Build the APK with the project's own tooling and run unit-testable
logic with its test suite; use the device for what only a device can show.
Command output is JSON. The full command list and current limits are in
[the agent reference](https://ramus.dev/agents.md).
## Checklist
Copy this and check it off as you go:
```
- [ ] Get access: `ramus status`, then `ramus trial` or RAMUS_API_KEY
- [ ] Start a session from an APK, demo or PR, with --wait
- [ ] Share the watch link with the person right away
- [ ] Drive the flow: snapshot → act with ref+gen → re-snapshot
- [ ] On failure, capture logcat and a screenshot before relaunching
- [ ] Report evidence and the current watch link; end the session unless handing off
```
## Get a device
1. `ramus status` shows credentials, GitHub installation and live sessions.
2. No credentials? `ramus trial` stores a 60-minute sandbox key. Trials
run APKs and demos, not PRs, adb or the dev loop. For full access the
person creates a key at https://ramus.dev/settings and sets
`RAMUS_API_KEY`. Never ask for credentials in chat or put them in URLs.
3. Start from exactly one source:
- `ramus session start --apk app-debug.apk --wait` for a local build.
- `ramus session start --demo --wait` for the sample app
(`--demo <name>`; `ramus session start --help` lists names).
- `ramus session start --pr owner/repo#123 --wait`