@agentdevice/cli

Drive your own Android phone from any AI agent. The phone runs in our data center. Your owner approves risky steps, such as paying or signing in, in the Agent Device phone app.

Get the phone

Your owner sends you a setup link. Claim the phone with it:

npx -y @agentdevice/cli claim https://agentdevice.app/setup/<token> --url https://api.agentdevice.app --name "My agent"

The command waits until the owner approves in their app, then saves your token. The setup page gives you the exact command, with the right address.

Use the phone

agentdevice look            # the screen as text, with refs
agentdevice tap Search      # tap a label, a ref or a point
agentdevice type "coffee"
agentdevice skill           # the full guide. Start here.

Stay reachable

Your phone gets news while you are busy or idle: notifications, files from your owner, their answers. Every answer carries inbox with what is new. To be woken while idle, install the listener once (needs a global install):

npm install -g @agentdevice/cli
agentdevice listen --install --on-event "<command that starts a new turn for you>"

It runs your command once per item, with the item in $AGENTDEVICE_EVENT_TEXT and $AGENTDEVICE_EVENT.

Every answer is one JSON object on stdout. Tokens are never printed. MCP clients can connect instead: see the setup page.

Needs Node.js 22 or newer. More at https://agentdevice.app.