Haoleme

Monitor commands on your computer or server from your phone.

[!TIP] Codex / Claude Code Skills are now supported

Codex and Claude Code can automatically identify important training, full evaluations, and long-running tasks, then use hao to sync status and output to the Haoleme app. Dependency installs, quick pretests, and other routine commands stay local. See installation

Website · Download APK · Quick Start · PyPI

Official Links

• Website: https://haolemeapp.github.io/
• GitHub: https://github.com/HaolemeApp/Haoleme

What Is It

Haoleme is a command monitoring tool.

Start a command with hao, then watch its status, console output, device online state, and finish notification in the mobile app. It is useful for training jobs, remote scripts, batch tasks, crawlers, long SSH sessions, and anything you do not want to babysit in a terminal.

Preview

The home screen shows active and completed runs in one place. Settings covers pairing, shared spaces, appearance, and security options.

Quick Start

1. Download the App

Download Android APK 0.9.43

2. Install the CLI

pip install -U haoleme

3. Pair a Device

hao login

Choose Haoleme Cloud or a self-hosted Private Relay, then open the app and scan the QR code or enter the 6-digit pairing code.

4. Run a Command

Prefix your original command with hao:

hao python train.py
hao bash script.sh
hao echo hello

The app will show status and console output automatically.

5. Let Codex / Claude Code Monitor Important Tasks

Install the skill globally for both Codex and Claude Code:

npx skills add HaolemeApp/Haoleme --skill monitor-with-haoleme -g -a codex -a claude-code -y

The skill adds hao to training, full evaluations, long batch jobs, and other important work. It leaves dependency installs, quick pretests, formatting, and routine Git commands local.

Features

• running / succeeded / failed status
• console output and search
• finish notifications
• multiple devices and online status
• device rename
• project grouping
• GPU / CPU monitoring
• QR code and 6-digit pairing
• end-to-end encryption for sensitive run content

Source

• CLI and cloud protocol: src/haoleme
• Android app: android
• Cloud deployment examples: deploy

Security

The public source tree does not include official signing keys, private production deployment config, real IP addresses, passwords, personal donation QR codes, or access tokens.

Official Android signing material and server credentials are injected through environment variables or private local configuration. See SECURITY.md for reporting guidance.

The app and CLI connect to the official service by default. You can also self-host from source. Do not commit your own keys, tokens, databases, signing files, or server passwords to a public repository.

Private Relay

The normal Haoleme app also works with a self-hosted relay; no custom APK is required. Deploy the Docker/Caddy stack in deploy/RELAY.md, then pair a computer with one command:

hao login https://hao.example.com

Scanning that QR switches the app to the named relay. App credentials and E2EE keys are isolated per relay, and private-relay QR codes never fall back to the public Haoleme service.

For a trusted local network, a domain is optional:

hao login

Choose Private Relay, then Start a LAN Relay on this computer. hao starts it in the background and immediately shows the pair code and QR. Other computers can use the LAN address it prints. For explicit Relay-only control, haoleme-relay --lan --port 8000 remains available; add --no-pair to keep it in the foreground without pairing the Relay host.

Local HTTP is restricted to private IP addresses. Keep it inside the LAN; use HTTPS for any Internet-facing relay. See deploy/RELAY.md.

License

Haoleme is licensed under AGPL-3.0-or-later.