#274 by GitHub stars
callstack/agent-device
Open source device layer for AI coding agents: a CLI, MCP server, and typed Node.js API to control mobile, web, TV, and desktop apps on devices and simulators, locally or in the cloud.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
skills/agent-device/SKILL.md
Week of Nov 2, 2026 · Line counts unavailable
Before Not checked yet → After Instructions only
First observation → e6ac165961de
No earlier version was observed for comparison.
skills/android-emulator/SKILL.md
Week of Nov 2, 2026 · Line counts unavailable
Before Not checked yet → After Instructions only
First observation → e6ac165961de
No earlier version was observed for comparison.
skills/dogfood/SKILL.md
Week of Nov 2, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → e6ac165961de
No earlier version was observed for comparison.
skills/ios-simulator/SKILL.md
Week of Nov 2, 2026 · Line counts unavailable
Before Not checked yet → After Instructions only
First observation → e6ac165961de
No earlier version was observed for comparison.
Verified commit e6ac165961def2f7b80336d2c04586a3ace32ce0
git clone --filter=blob:none --no-checkout https://github.com/callstack/agent-device.git .hotskills/callstack-agent-device && git -C .hotskills/callstack-agent-device checkout --detach e6ac165961def2f7b80336d2c04586a3ace32ce0
# Copy each selected skill directory from .hotskills/callstack-agent-device into .agents/skills/<skill-name>/Heat
7.0- Star growth, last 7 daysAhead of 89% of tracked repositories
- Star growth, last 24 hoursAhead of 84% of tracked repositories
- Rank movement, last 7 daysAhead of 43% of tracked repositories
- Commits, last 30 daysAhead of 99% of tracked repositories
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekAhead of 0% of tracked repositories
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
Individual skills in this repository
- agent-device
skills/agent-device - android-emulator
skills/android-emulator - dogfood
skills/dogfood - ios-simulator
skills/ios-simulator
How it works
agent-device
When your agent uses it
Automates Apple-platform apps (iOS, tvOS, macOS), Android devices (including Android TV and Fire TV on Fire OS), and Amazon Vega OS TV apps in Vega Virtual Devices. Use when navigating apps, taking snapshots/screenshots where supported, driving TV remotes, tapping, typing, scrolling, extracting UI info, collecting evidence, or planning agent-device CLI commands.
What it loads into context
Frontmatter
83 tokensAlways available to the agent
SKILL.md
522 tokensWhen the skill is activated
Reference documents
0 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
Files
SKILL.mdcore2,191 bytesSKILL.mdcore2,191 bytes
Read SKILL.md
# agent-device
For a normal app-driving task, start immediately. Do not probe first with `--help`, `--version`, `devices`, `appstate`, `snapshot`, or `screenshot`:
```bash
agent-device open <app> --foreground
```
That starts the session and returns the initial interactive snapshot with `@refs`.
Loop: act with `press|click|fill|longpress <target> ... --settle`, `scroll <direction> --settle`, or `back --settle`; continue from the printed diff, verify the named expectation (`wait text "..."`, `is`, `get`, or `find`), then run `agent-device close`, or `agent-device close --shutdown` if your session booted a local simulator or emulator, unless the user asks to keep it running.
Reaching an off-screen target is one command, not a scroll-and-check loop: `scroll down --until <selector>` scrolls until that element is on screen, and `scroll bottom` runs to the end of the content. Repeated bare `scroll down` calls are the slow way to find something.
View the complete source on GitHubandroid-emulator
When your agent uses it
Verify and debug native, React Native, Expo, or Flutter apps on an Android Emulator with agent-device. Use when an agent needs to launch an app, inspect its live UI, tap, type, scroll, validate a code change, collect failure evidence, or reproduce a workflow on an Android virtual device.
What it loads into context
Frontmatter
69 tokensAlways available to the agent
SKILL.md
375 tokensWhen the skill is activated
Reference documents
0 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
Files
SKILL.mdcore1,808 bytesSKILL.mdcore1,808 bytesSKILL.mdcore1,808 bytesSKILL.mdcore1,808 bytes
Read SKILL.md
# Android Emulator
Require the `agent-device` CLI to be installed separately before driving an emulator:
```bash
npm install -g agent-device@latest
```
Treat installation and upgrades as user-owned setup steps. Do not run that command autonomously or substitute a mutable `npx -y agent-device@latest` invocation.
For a normal app-driving task, start immediately. Do not probe first with `--help`, `--version`, `devices`, `appstate`, `snapshot`, or `screenshot`. Target Android explicitly when opening an app or package id:
```bash
agent-device open <app-or-package-id> --platform android --foregroundView the complete source on GitHubdogfood
When your agent uses it
Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems. Use when asked to dogfood, QA, exploratory test, find issues, bug hunt, or test this app on mobile.
What it loads into context
Frontmatter
74 tokensAlways available to the agent
SKILL.md
330 tokensWhen the skill is activated
Reference documents
0 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
Files
SKILL.mdcore1,479 bytesSKILL.mdcore1,479 bytesSKILL.mdcore1,479 bytesSKILL.mdcore1,479 bytes
Read SKILL.md
# Dogfood
Router for exploratory QA. Private setup before using this skill:
```bash
agent-device --version
```
If that fails, stop and tell the user to expose a trusted `agent-device` binary on PATH or approve an exact-version npm command. This skill intentionally keeps allowed tools restricted to `agent-device` and `npx agent-device`.
Require `agent-device >= 0.14.0`; older CLIs lack these help topics. If older, stop and tell the user to upgrade the trusted install or approve an exact-version npm command. Do not run `npm install -g agent-device@latest` or `npx -y agent-device@latest` autonomously, and do not include version/upgrade commands in final plans.
Read current CLI guidance:
View the complete source on GitHubios-simulator
When your agent uses it
Verify and debug native, React Native, Expo, or Flutter apps on an iOS Simulator with agent-device. Use when an agent needs to launch an app, inspect its live UI, tap, type, scroll, validate a code change, collect failure evidence, or reproduce a workflow on an iPhone or iPad Simulator.
What it loads into context
Frontmatter
73 tokensAlways available to the agent
SKILL.md
382 tokensWhen the skill is activated
Reference documents
0 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
Files
SKILL.mdcore1,792 bytesSKILL.mdcore1,792 bytesSKILL.mdcore1,792 bytesSKILL.mdcore1,792 bytes
Read SKILL.md
# iOS Simulator
Require the `agent-device` CLI to be installed separately before driving a simulator:
```bash
npm install -g agent-device@latest
```
Treat installation and upgrades as user-owned setup steps. Do not run that command autonomously or substitute a mutable `npx -y agent-device@latest` invocation.
For a normal app-driving task, start immediately. Do not probe first with `--help`, `--version`, `devices`, `appstate`, `snapshot`, or `screenshot`. Target iOS explicitly when opening an app or bundle id:
```bash
agent-device open <app-or-bundle-id> --platform ios --foregroundView the complete source on GitHubSkills included
- agent-device
- android-emulator
- dogfood
- ios-simulator
Repository facts
- License
- MIT
- Created
- Jan 30, 2026
- Last pushed
- Nov 5, 2026
- Forks
- 382
- Open issues
- 90
- Project activity
- Active
Rank over the last 12 weeks
Now #274 · best #227 · down 32 in 30 days
- #267 on Oct 31
- #268 from Nov 1 to Nov 2
- #269 on Nov 3
- #270 on Nov 4
- #271 on Nov 5
- #274 since Nov 6
62 earlier periods
- #226 on Aug 2
- #226 on Aug 7
- #227 on Aug 8
- #224 on Aug 9
- #230 on Aug 10
- #229 on Aug 11
- #226 on Aug 12
- #229 from Aug 13 to Aug 14
- #228 on Aug 15
- #227 from Aug 16 to Aug 17
- #231 from Aug 18 to Aug 19
- #229 on Aug 20
- #232 on Aug 21
- #229 on Aug 22
- #234 from Aug 23 to Aug 24
- #235 from Aug 25 to Aug 26
- #236 on Aug 27
- #234 from Aug 28 to Aug 29
- #232 from Aug 30 to Aug 31
- #237 on Sep 1
- #232 on Sep 2
- #239 on Sep 3
- #234 on Sep 4
- #237 on Sep 5
- #234 on Sep 6
- #236 from Sep 7 to Sep 8
- #237 on Sep 9
- #236 on Sep 10
- #237 from Sep 11 to Sep 12
- #239 from Sep 13 to Sep 15
- #237 on Sep 16
- #235 on Sep 17
- #239 on Sep 18
- #236 on Sep 19
- #239 from Sep 20 to Sep 22
- #240 from Sep 23 to Sep 24
- #239 from Sep 25 to Sep 27
- #241 from Sep 28 to Sep 29
- #238 on Sep 30
- #240 on Oct 1
- #242 on Oct 2
- #237 from Oct 3 to Oct 4
- #239 on Oct 5
- #240 on Oct 6
- #242 from Oct 7 to Oct 8
- #246 on Oct 9
- #242 on Oct 10
- #245 on Oct 11
- #249 on Oct 12
- #250 on Oct 13
- #248 on Oct 14
- #247 from Oct 15 to Oct 16
- #250 from Oct 17 to Oct 18
- #252 on Oct 19
- #253 on Oct 20
- #254 from Oct 21 to Oct 22
- #252 on Oct 23
- #255 on Oct 24
- #258 on Oct 25
- #260 on Oct 28
- #264 on Oct 29
- #266 on Oct 30
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 6, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 10 notes
skills/agent-device/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/android-emulator/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/android-emulator/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/android-emulator/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/dogfood/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/dogfood/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/dogfood/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/ios-simulator/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/ios-simulator/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/ios-simulator/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- 1 broad permissionin 1 file: dogfood/SKILL.md:1
- No dangerous shell commands
- No network access
- No hidden or obfuscated text
- No instruction overrides
- No executable scripts
- No access to secrets
- No requests to vote in Hot
Show the signal with its line
skills/dogfood/SKILL.md
- Broad permissionsline 1
Bash(agent-device:*), Bash(npx agent-device:*)
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
Signal confidence: 1 fact
- Broad permissions in the frontmatter of the SKILL.mddogfood/SKILL.md:1High confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md skills/agent-device/SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Native | Manifest AGENTS.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md skills/agent-device/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md skills/agent-device/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md skills/agent-device/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md skills/agent-device/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
Add this badge to your README
It updates every night and links to this page.
[](https://hotskills.dev/skill/callstack-agent-device/)