Metadata-Version: 2.5
Name: hiair-cli
Version: 0.3.1
Summary: Run HiAir applies in your own Chrome
Project-URL: Homepage, https://hiair.ai
Project-URL: Repository, https://github.com/hiair-ai/hiair-cli
Project-URL: Issues, https://github.com/hiair-ai/hiair-cli/issues
Author-email: HiAir <admin@hiair.ai>
License: MIT
License-File: LICENSE
Keywords: apply,chrome,hiair,jobs
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: playwright>=1.62
Description-Content-Type: text/markdown

# HiAir CLI

Fill job applications in **your** Chrome, then store them in the HiAir tracker.

## Install

You need [Python 3.11+](https://www.python.org/downloads/) and [pipx](https://pipx.pypa.io/). Google Chrome must be installed for applies.

```bash
pipx install hiair-cli
# or: uv tool install hiair-cli

hiair login
```

`hiair login` offers to install the login worker for you (or run
`hiair service install` yourself later). If something misbehaves, run
`hiair doctor`.

After that, the worker starts at login. Queue jobs from the website or copilot; when one arrives, this Mac opens a disposable Chrome, fills the application, and writes the result back. Everyday Chrome can stay open. Logins in the HiAir window do not persist.

Closing a tab stops that application; closing the HiAir Chrome window stops all of
them. Stopped applications show as stopped in the app and their credits come back,
and the worker waits 30 seconds before opening Chrome for the next queued job.
Ctrl-C in a foreground `hiair apply` stops the in-flight applications the same way.

`hiair service` is macOS only. To watch a run in the foreground (any OS), use `hiair apply`.

### Several applications at once

`hiair apply` fills up to four queued applications at the same time, each in its own tab of
the one HiAir Chrome window, so a batch queued from the site finishes in a fraction of the time.
`hiair apply --parallel 6` raises the limit (max 8), `--parallel 1` goes back to one at a time,
and `HIAIR_APPLY_PARALLEL` sets the default for the login service. The server still hands out
one application per company career site at a time, so the parallelism is across companies. When
one tab needs you, it comes to the front and the terminal prompt is for that tab only; the others
keep working.

## When the agent needs you

If the form asks something your profile cannot answer, shows a captcha, sends
you a code, or wants you to sign in, the apply **pauses with the page still
open** in the HiAir Chrome window. You get a desktop notification, the field is
highlighted, and `hiair apply` prints what is needed. Then either:

- fix it in the browser and press **Enter** in the terminal,
- press **a** and type the answers in the terminal (the agent types them into
  the form), or
- press **s** if you clicked Submit yourself.

You can also answer from the HiAir website; the daemon notices and carries on.
If nothing happens for about 45 minutes the run falls back to "Needs you" on
the website and the page closes. The login service (no terminal) still pauses
and waits for the website.

```bash
hiair --version
hiair status
hiair service status
hiair service uninstall
```
