Android Harness

android-harness

Turn an Android phone into a full agent environment — Python, Node, **Claude Code**, camera, location, clipboard, notifications, shared storage, UI automation — provisioned in one command from your Mac over USB.

Maximum local capability, minimum attack surface. The control channel is bound to `127.0.0.1` on the phone and reachable only through the USB cable. Nothing listens on the network, nothing starts at boot, nothing calls home. A security audit runs at the end of every install and has to pass.

Verified on a Pixel 7a, Android 17, Termux 0.118.3: Claude Code 2.1.251, Python 3.14.6, Node v24.18.0, 23 capabilities, `SECURITY AUDIT: PASS`.

---

Contents

• What you get
• Prerequisites
• Install
• Using it on the phone
• Using it from the Mac
• Permissions
• Controlling it from the phone
• Architecture
• Security model
• Reset and recovery
• Troubleshooting
• Supply chain

---

What you get

On the phone, under `~/android-agent`:

Claude Code	working on Android, launched by tapping a home-screen icon or typing claude
Python	3.x with pip and venv, plus a ready-made default venv
Node.js	with npm, global prefix kept inside the agent tree
Android bridge	17 android-* commands: battery, wifi, location, camera, clipboard, notify, vibrate, volume, brightness, open, share, wake lock
Shared storage	DCIM, Pictures, Download, Documents, Movies, Music
Diagnostics	android-agent-status, a capability manifest, an end-to-end test suite, a security audit

On the Mac, one CLI called `aa`:

Shell and files	aa shell, aa push, aa pull
Claude Code	aa claude — runs it on the phone with a real TTY