> ## Documentation Index
> Fetch the complete documentation index at: https://hiair.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Command Reference

> Every hiair-cli command and flag

<Note>
  This covers the commands job-seekers use day to day. It doesn't include the commands built for driving `hiair-cli` from a coding agent — see `hiair skill install` below if that's what you're after.
</Note>

## Account

### `hiair login`

Pairs this computer with your Hiair account. Prints a code, opens your browser to confirm it, and saves a device token here once confirmed.

```bash theme={null}
hiair login [--api-url URL]
```

### `hiair logout`

Removes the saved token from this computer and revokes it server-side.

```bash theme={null}
hiair logout
```

## Status

### `hiair status`

Shows pairing, whether this device is online, the login worker's state, and whether the HiAir Chrome window is running.

```bash theme={null}
hiair status
```

### `hiair doctor`

Checks Chrome, pairing, and the login worker in one pass, and reports what's wrong.

```bash theme={null}
hiair doctor
```

### `hiair --version`

Prints the installed version.

```bash theme={null}
hiair --version
```

## Applying

### `hiair apply`

Claims queued applications and fills them in Chrome, in the foreground. Ctrl-C stops any in-flight applies.

```bash theme={null}
hiair apply [--parallel N] [--api-url URL]
```

| Flag            | Description                                                                                                                                |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `--parallel N`  | How many applications to fill at once, each in its own tab of the same Chrome window. Default 4, max 8. `--parallel 1` runs one at a time. |
| `--api-url URL` | Point at a different Jobs API base URL.                                                                                                    |

See [Applying from the CLI](/cli/apply) for how the queue, parallel tabs, and needs-your-input pauses work.

## Login worker (macOS)

The login worker runs `hiair apply` automatically at login, so you don't need a terminal open. It's macOS only — on other platforms, run `hiair apply` directly.

```bash theme={null}
hiair service install
hiair service status
hiair service uninstall
```

| Command             | Description                                    |
| ------------------- | ---------------------------------------------- |
| `service install`   | Start the login worker now and at every login. |
| `service status`    | Show whether the worker is loaded.             |
| `service uninstall` | Stop and remove the login worker.              |

## Device console

### `hiair wakeup`

Opens a small native window with pairing status, the login worker, applies currently running, health checks, and the worker log. Needs the `gui` extra:

```bash theme={null}
pipx install 'hiair-cli[gui]'
# or: uv tool install 'hiair-cli[gui]'

hiair wakeup
```

## Updating

```bash theme={null}
hiair update [--check]
```

`hiair update` checks PyPI and installs the latest release. `--check` only reports whether an update is available, without installing it.

<Note>
  The login worker updates itself automatically between applications by default. Turn this off in the console's settings if you'd rather approve each update.
</Note>

## Agent skill

### `hiair skill install` / `hiair skill uninstall`

Writes (or removes) a self-contained skill file that teaches a coding agent — Cursor, Claude, ChatGPT, GitHub Copilot, or Gemini — the `hiair` command surface, so it can check status and run applies on your behalf.

```bash theme={null}
hiair skill install [--client AGENT] [--global] [--dir PATH]
hiair skill uninstall [--client AGENT] [--global] [--dir PATH]
```

| Flag             | Description                                                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `--client AGENT` | Which agent to install for: `cursor`, `claude`, `chatgpt`, `copilot`, `gemini`, or `all`. Repeatable. Asked interactively if omitted. |
| `--global`       | Install to the agent's home-directory skill folder instead of the current project.                                                    |
| `--dir PATH`     | Install into a specific directory instead of an agent's usual skill folder.                                                           |