claude-in-mobile

# claude-in-mobile CLI

Fast CLI for mobile device automation across **Android** (via ADB), **iOS** (via simctl), **Aurora OS** (via audb), and **Desktop** (via companion JSON-RPC app).

Binary: `claude-in-mobile` (ensure it's in PATH or use full path to the built binary).

## Common Flags

Most commands accept platform-specific device selectors:

| Flag | Description | Platforms |
|------|-------------|-----------|
| `--device <serial>` | Android/Aurora device serial (default: first connected) | Android, Aurora |
| `--simulator <name>` | iOS Simulator name (default: booted) | iOS |
| `--companion-path <path>` | Path to Desktop companion app (or set `MOBILE_TOOLS_COMPANION` env) | Desktop |

---

## Commands Reference

### devices

List connected devices across platforms.

```bash
claude-in-mobile devices              # All platforms
claude-in-mobile devices android      # Android only
claude-in-mobile devices ios          # iOS simulators only
claude-in-mobile devices aurora       # Aurora devices only
```

**Platforms:** Android, iOS, Aurora

---

### screenshot

Capture a screenshot. Outputs base64 to stdout by default, or save to file with `-o`.

```bash
claude-in-mobile screenshot android
claude-in-mobile screenshot ios
claude-in-mobile screenshot aurora
claude-in-mobile screenshot desktop --companion-path /path/to/companion

# Save to file
claude-in-mobile screenshot android -o screen.png

# Compress for LLM (resize + JPEG quality reduction)
claude-in-mobile screenshot android --compress --max-width 800 --quality 60
```

| Flag | Description | Default |
|------|-------------|---------|
| `-o, --output <path>` | Save to file instead of base64 stdout | stdout |
| `-c, --compress` | Enable compression (resize + quality) | false |
| `--max-width <px>` | Max width when compressing | 1024 |
| `--max-height <px>` | Max height when compressing | unlimited |
| `--quality <1-100>` | JPEG quality when compressing | 80 |
| `--monitor-index <n>` | Monitor index (Desktop) |