\r \r

Hamibot CLI\r

\r Remote Android automation command-line tool. Connect to the Hamibot cloud API to control Android devices:\r execute JavaScript code, manage files, simulate touch input, capture screenshots, launch apps, and query device info.\r \r Official site: https://hamibot.com\r Repository: https://github.com/hamibot/cli\r \r

Security Model\r

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

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.\r \r
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.\r \r
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.\r \r
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.\r \r
5. Open Source. The CLI is fully open source at https://github.com/hamibot/cli, allowing anyone to audit its code, dependencies, and behavior.\r \r 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.\r \r

Installation\r

\r

Prerequisites\r

\r

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

Install as Global CLI\r

\r

npm install -g hamibot/cli\r
hamibot -v\r
```\r
\r
### Install from Source\r
\r
```bash\r
git clone https://github.com/hamibot/cli.git\r
cd cli\r
npm install\r
npm link\r
```\r
\r
## Quick Start\r
\r
```bash\r
# 1. Login (interactive prompt for phone/email + password)\r
hamibot login\r
\r
# 2. List paired devices\r
hamibot devices\r
\r
# 3. Execute code on device\r
hamibot exec -c 'toast("Hello from CLI!")'\r
```\r
\r
## Authentication\r
\r
### Interactive Login\r
\r
```bash\r
hamibot login\r
```\r
\r
### Token Login (recommended for CI/CD)\r
\r
1. Create a Personal Access Token at https://hamibot.com/account/tokens\r
2. Login with the token:\r
\r
```bash\r
hamibot login -t hmp_xxxxxxxxxxxx\r
```\r
\r
## Global Options\r
\r
Available on all commands:\r
\r
| Flag | Purpose |\r
|------|---------|\r
| `-d, --device \x3Cid>` | Target device ID (repeatable for multi-device parallel) |\r
| `-j, --json` | Structured JSON output for piping and scripting |\r
| `--debug [namespace]` | Debug logging with optional namespace filter |\r
\r
### Device Selection\r
\r
Without `-d`, CLI auto-selects a device:\r
1. If a default device is configured → use it\r
2. If only one device paired → auto-select\r
3. Multiple devices → interactive prompt (enter `0` to select all)\r
\r
### Multi-Device Parallel\r
\r
```bash\r
hamibot input tap 500 500 -d device-A -d device-B\r
```\r
\r
## Commands Reference\r
\r
### Code Execution\r
\r
```bash\r
hamibot exec -c 'toast("Hello!")'\r
hamibot exec -f ./script.js\r
echo 'toast("Hello!")' | hamibot exec\r
```\r
\r
### File Management\r
\r
```bash\r
hamibot file ls                          # List /sdcard\r
hamibot file ls /sdcard/Download\r
hamibot file download /sdcard/file.png    # Download to current dir\r
hamibot file download /sdcard/file.png ./local.png\r
hamibot file upload ./local.txt /sdcard/\r
hamibot file cat /sdcard/log.txt\r
```\r
\r
### Input Control\r
\r
```bash\r
hamibot input tap 500 500\r
hamibot input click 500 500              # alias\r
hamibot input longtap 500 500\r
hamibot input longtap 500 500 --duration 1000\r
hamibot input swipe 500 1500 500 500 --duration 300\r
hamibot input gesture 500 100 200 300 400 500 600 700\r
```\r
\r
### Launch App\r
\r
```bash\r
hamibot launch com.example.app\r
hamibot launch com.example.app --activity .MainActivity\r
```\r
\r
### Device Management\r
\r
```bash\r
hamibot devices                          # List all devices\r
hamibot devices info \x3CdeviceId>\r
hamibot devices online                   # Check online status\r
```\r
\r
### Run Saved Script\r
\r
```bash\r
hamibot run \x3CscriptId>\r
```\r
\r
### Configuration\r
\r
```bash\r
hamibot config defaultDevice \x3Cid>        # Set default device\r
hamibot config defaultDevice --get       # Get config value\r
hamibot config --reset                   # Clear all config\r
```\r