Skip to main content

​
Install

You need Python 3.11+ and Google Chrome. Install hiair-cli with uv or pipx — either works, uv is faster.
If you don’t have uv yet:
Then install the CLI:

​
Pair your computer

This prints a short code and opens your browser to enter it, confirming the pairing with your Hiair account. On macOS it then asks whether to install the login worker, so applies can run in the background — say yes, or install it later with hiair service install (see the command reference). If anything looks off after installing, run hiair doctor — it checks Chrome, pairing, and the login worker in one pass.

​
Unpairing

Removes the token from this computer and revokes it on the server. To finish removing a computer you no longer have access to, remove the device from hiair.ai directly.

​
Where the token lives

Pairing stores a device token. On macOS it’s kept in the Keychain; on other platforms — or if the Keychain isn’t available — it falls back to ~/.hiair/credentials, a file only your account can read.
The token only ever talks to the Hiair API it was issued for. Passing a custom --api-url refuses to send your token anywhere else unless you explicitly opt in — see Troubleshooting.
Next: the full command reference, or jump straight to applying from the CLI.