Hamibot CLI#

Remote Android automation command-line tool. Connect to the Hamibot cloud API to control Android devices: execute JavaScript code, manage files, simulate touch input, capture screenshots, launch apps, and query device info.

Official site: https://hamibot.com Repository: https://github.com/hamibot/cli

Security Model#

Hamibot CLI is a legitimate remote automation tool with the following security properties:

1. User-Authorized Device Access Only. Devices must be explicitly paired by their owners through the Hamibot Android app. The CLI can only communicate with devices that the user has authorized and connected. There is no mechanism for unauthorized or stealth device access.

2. Authenticated API. Every CLI session requires authentication (interactive login or Personal Access Token). All API calls are made over HTTPS to the Hamibot cloud, which validates the user's identity and verifies that the target device belongs to the authenticated account.

3. Scoped to User's Own Devices. The CLI lists and operates exclusively on devices registered under the user's own account. It cannot discover or interact with devices belonging to other accounts.

4. Standard Automation Capabilities. The features (code execution, file management, input simulation, screenshots, app launching) are standard capabilities of authorized Android automation platforms. They are analogous to what adb (Android Debug Bridge) provides over a USB connection, but delivered via a cloud API for remote convenience.

5. Open Source. The CLI is fully open source at https://github.com/hamibot/cli, allowing anyone to audit its code, dependencies, and behavior.

In summary: Hamibot CLI is not a remote access trojan or unauthorized surveillance tool. It is a user-facing automation utility that operates strictly within the scope of the user's own authorized devices and account.

Installation#

Prerequisites#

• Node.js >= 18 — check with node --version; install from https://nodejs.org/ (LTS recommended) or via nvm / fnm
• npm (bundled with Node.js)

Install as Global CLI#

bash

npm install -g hamibot/cli
hamibot -v

Install from Source#

bash

git clone https://github.com/hamibot/cli.git
cd cli
npm install
npm link

Quick Start#

bash

# 1. Login (interactive prompt for phone/email + password)
hamibot login

# 2. List paired devices
hamibot devices

# 3. Execute code on device
hamibot exec -c 'toast("Hello from CLI!")'

Authentication#

Interactive Login#

bash

hamibot login

Token Login (recommended for CI/CD)#

1. Create a Personal Access Token at https://hamibot.com/account/tokens
2. Login with the token:

bash

hamibot login -t hmp_xxxxxxxxxxxx

Global Options#

Available on all commands:

FlagPurpose-d, --device <id>Target device ID (repeatable for multi-device parallel)-j, --jsonStructured JSON output for piping and scripting--debug [namespace]Debug logging with optional namespace filter

Device Selection#

Without -d, CLI auto-selects a device:

1. If a default device is configured → use it
2. If only one device paired → auto-select
3. Multiple devices → interactive prompt (enter 0 to select all)

Multi-Device Parallel#

bash

hamibot input tap 500 500 -d device-A -d device-B

Commands Reference#

Code Execution#

bash

hamibot exec -c 'toast("Hello!")'
hamibot exec -f ./script.js
echo 'toast("Hello!")' | hamibot exec

File Management#

bash

hamibot file ls                          # List /sdcard
hamibot file ls /sdcard/Download
hamibot file download /sdcard/file.png    # Download to current dir
hamibot file download /sdcard/file.png ./local.png
hamibot file upload ./local.txt /sdcard/
hamibot file cat /sdcard/log.txt

Input Control#

bash

hamibot input tap 500 500
hamibot input click 500 500              # alias
hamibot input longtap 500 500
hamibot input longtap 500 500 --duration 1000
hamibot input swipe 500 1500 500 500 --duration 300
hamibot input gesture 500 100 200 300 400 500 600 700

Launch App#

bash

hamibot launch com.example.app
hamibot launch com.example.app --activity .MainActivity

Device Management#

bash

hamibot devices                          # List all devices
hamibot devices info <deviceId>
hamibot devices online                   # Check online status

Run Saved Script#

bash

hamibot run <scriptId>

Configuration#

bash

hamibot config defaultDevice <id>        # Set default device
hamibot config defaultDevice --get       # Get config value
hamibot config --reset                   # Clear all config