> ## 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.

# CLI Troubleshooting

> Fixing the most common hiair-cli problems

Start with:

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

It checks Chrome, pairing, and the login worker in one pass, and tells you what's wrong.

<AccordionGroup>
  <Accordion title="My device shows as offline">
    The login worker isn't running. Install or restart it:

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

    This is macOS only. On other platforms, run `hiair apply` in a terminal instead — applications only fill while it's running.
  </Accordion>

  <Accordion title="My pairing code expired">
    Pairing codes are only valid for a few minutes. Run `hiair login` again and confirm the new code right away.
  </Accordion>

  <Accordion title="Chrome isn't found">
    `hiair-cli` needs Google Chrome installed on the paired computer — it opens a disposable Chrome window to fill each application. Install Chrome, then run `hiair doctor` to confirm it's detected.
  </Accordion>

  <Accordion title="I need to point the CLI at a different API">
    Passing `--api-url` (or setting `$HIAIR_API_URL`) to a host other than the one your token was issued for is refused by default — the CLI won't hand your token to another backend. If you're intentionally running against a development backend you trust, set:

    ```bash theme={null}
    HIAIR_ALLOW_CUSTOM_API=1
    ```

    Don't set this unless you know exactly which backend you're pointing at.
  </Accordion>

  <Accordion title="An application has been stuck on 'Needs you' for a while">
    If a paused application goes unanswered for about 45 minutes, the run closes on its own and shows as "Needs you" in your [application tracker](/features/application-tracker). Nothing to fix on the CLI side — the next queued application will pick up normally.
  </Accordion>
</AccordionGroup>

Still stuck? [Contact support](/troubleshooting) — include what you ran and what `hiair doctor` reported.