phonedriver — Claude Code skill for phone control
The phonedriver Claude Code skill reads and operates Android and iOS screens. It handles app navigation, text entry, taps and device settings.
AGPL-3.0 ★ 342 updated 2026-11-16
npx skills add hridaya423/phonedriver --skill phonedriver -a claude-codeWhat phonedriver does
phonedriver turns a phone screen into text the agent can inspect, then carries out actions in apps. It can tap listed elements, enter text, scroll and return the changed screen; screenshots cover visual content that text cannot describe. A sequence of expected taps can run in one call.
System settings and actions use shell commands. Physical iPhones have no shell access, and the user must unlock a device or approve USB debugging prompts. Android connection can fail when adb or USB debugging is unavailable. A person must approve purchases, deletions and outgoing messages.
What it helps with
- inspect the current screen of a mobile app
- open an app and navigate to a specific screen
- change an app or device setting
- enter text and select a matching suggestion
Example prompts for the agent
- Open the app and show me what is on screen.
- Go to settings and turn on dark mode.
- Enter Paris in the search field and choose the matching suggestion.
How to install phonedriver
1Skills CLI (Vercel)
npx skills add hridaya423/phonedriver --skill phonedriver -a claude-code2Manually: put the files in place
~/.claude/skills/phonedriver/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/phonedriver/
1Skills CLI (Vercel)
npx skills add hridaya423/phonedriver --skill phonedriver -a codex2Manually: put the files in place
.agents/skills/phonedriver/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hridaya423/phonedriver --skill phonedriver -a cursor2Manually: put the files in place
.cursor/skills/phonedriver/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hridaya423/phonedriver phonedriver2Manually: put the files in place
.github/skills/phonedriver/SKILL.md1Skills CLI (Vercel)
npx skills add hridaya423/phonedriver --skill phonedriver -a gemini-cli2Platform CLI
gemini skills install https://github.com/hridaya423/phonedriverManually: put the files in place
.devin/skills/phonedriver/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about phonedriver
How do I install phonedriver in Claude Code?
Run npx skills add hridaya423/phonedriver --skill phonedriver -a claude-code. The skill file is at ~/.claude/skills/phonedriver/SKILL.md.
What does phonedriver do?
It reads and controls Android or iOS screens, including tapping interface elements, typing, scrolling and opening apps.
What does phonedriver need to work?
Android connections may require adb and USB debugging. The user handles device unlocking and system prompts; physical iPhones do not provide shell access.