# phone-harness

phone-harness is a Claude Code skill that automates Android device control via USB debugging. It performs taps, text entry, and screenshots within mobile apps.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 567 repo stars
- Author: DuskBotAI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/DuskBotAI/duskbot/tree/HEAD/skills/phone-harness/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/phone-harness

## What it does

This tool operates a physical phone connected to an AI agent. It uses a set of `phone` commands to read the screen, launch apps, and interact with the UI. Always run the `status` command before starting any interaction to ensure the device is ready.

The tool interfaces directly with the hardware via ADB. For security reasons, never input passwords or payment details through the agent, as those steps require manual input on the phone itself. A physical Android device with USB debugging enabled is required.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add DuskBotAI/duskbot --skill phone-harness -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/phone-harness/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/phone-harness/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add DuskBotAI/duskbot --skill phone-harness -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/phone-harness/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add DuskBotAI/duskbot --skill phone-harness -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/phone-harness/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install DuskBotAI/duskbot skills/phone-harness
```

2. **Manually: put the files in place**
- File: `.github/skills/phone-harness/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add DuskBotAI/duskbot --skill phone-harness -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/DuskBotAI/duskbot --path skills/phone-harness
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/phone-harness/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/DuskBotAI/duskbot/tree/HEAD/skills/phone-harness/SKILL.md

## When to use it
- automate mobile app testing flows
- perform swipes and button taps
- extract text from the phone screen

## Example prompts
- Open `Instagram` on the phone and take a screenshot
- Tap the button labeled `Sign In`

## Similar
- [android-adb](https://affpapa.org/en/nevibecode/skills/android-adb.md) — skill · 1000 installs
- [phone_wait](https://affpapa.org/en/nevibecode/prompts/phone-wait.md) — prompt · ★ 9488 repo stars
- [phone_list_apps](https://affpapa.org/en/nevibecode/prompts/phone-list-apps.md) — prompt · ★ 9488 repo stars
- [open-autoglm-phone-agent](https://affpapa.org/en/nevibecode/skills/open-autoglm-phone-agent.md) — skill · 1400 installs
- [android-device-automation](https://affpapa.org/en/nevibecode/skills/android-device-automation.md) — skill · 5900 installs
- [orca-emulator-android](https://affpapa.org/en/nevibecode/skills/orca-emulator-android.md) — skill · 6000 installs

From the same set: [duskbotai/duskbot](https://affpapa.org/en/nevibecode/by/duskbotai/duskbot.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
