Hiair CLI

The terminal way to pair your computer

Applications fill in your own Chrome. Everyday Chrome can stay open; Hiair opens its own window. The CLI is the terminal alternative to the desktop app.

Get the desktop app Sign up I have a pairing code

What it does

The CLI is a local worker on your computer. After you pair it, applications you queue on hiair.ai fill in Chrome on that machine. The desktop app does the same job without a terminal; use this page when you want the commands.

Why your own Chrome matters is on Apply from Chrome.

Install

You need Python 3.11+ and Google Chrome. Install the CLI with uv. If uv is not installed yet, use the official installer or Homebrew first, then run the uv command again. uv installation.

CLIuv tool install hiair-cli

No uv?curl -LsSf https://astral.sh/uv/install.sh | sh

Homebrewbrew install uv

Prefer pipx?pipx install hiair-cli

Pair and start

hiair login opens a browser tab. Sign in if asked, then confirm the code. You can also paste the code at /cli/pair.

On macOS, hiair service install starts the worker at login. On other systems, leave hiair apply running in a terminal.

Pairhiair login

Machiair service install

Not a Mac?hiair apply

Device console

hiair wakeup opens a small window for pairing, the worker, live applications, and logs. Install the gui extra first. pipx is the alternative to the uv line.

uvuv tool install 'hiair-cli[gui]'

pipxpipx install 'hiair-cli[gui]'

Openhiair wakeup

Commands

Run these on the paired computer

hiair login: Pair this computer. A browser tab opens; sign in if asked, then confirm the code.
hiair apply: Fill queued applications in the foreground. Leave this running if you did not install the macOS login worker.
hiair apply --parallel N: How many applications to fill at once. Default 4, maximum 8. One application per company at a time.
hiair service install: On macOS, start the worker at login. On other systems, leave hiair apply running instead.
hiair service status: Whether the macOS login worker is installed.
hiair service uninstall: Stop the login worker. Does not unpair the account.
hiair status: Whether this computer is paired and the API can see it.
hiair logout: Unpair this computer and delete the local token.
hiair doctor: Check Chrome, pairing, and the login worker in one pass.
hiair wakeup: Open the device console: a live window for pairing, the worker, applications, and logs.

Skill install, --api-url, and hiair update are on the CLI command reference.

When the agent needs you

A tab pauses with the page open. Press Enter after you fix it in the browser, press a and type the answer, or press s if you already submitted. You can also answer on the website. Other tabs keep going. After about 45 minutes the run shows as Needs you and the page closes.

Several applications at once

hiair apply --parallel N fills several applications at once. The default is 4 and the maximum is 8. One application per company at a time.