# Install

Install hq with npm. It needs Node.js 20 or newer, has no dependencies, and runs no install scripts.



## Install with npm [#install-with-npm]

<Tabs items="['macOS / Linux', 'Windows']">
  <Tab value="macOS / Linux">
    ```bash
    npm i -g @aiworkforceoneofficial/hq --ignore-scripts
    ```
  </Tab>

  <Tab value="Windows">
    ```powershell
    npm i -g @aiworkforceoneofficial/hq --ignore-scripts
    ```
  </Tab>
</Tabs>

<Callout title="Why --ignore-scripts.">
  The package has no dependencies and no install scripts. The flag makes npm guarantee that nothing
  runs during the install, for this package and anything else in the same command.
</Callout>

Check that it worked:

```bash
hq --version
hq --help
```

`hq --version` prints the version, `0.3.2` at the time of writing, and `hq --help` lists the
commands. See the [CLI reference](/docs/cli/reference/) for each one.

## Requirements [#requirements]

* **Node.js 20 or newer**, with npm. Run `node --version` to check.
* **macOS, Linux or Windows.**

## Update [#update]

Run the same install command again.

```bash
npm i -g @aiworkforceoneofficial/hq --ignore-scripts
```

## Uninstall [#uninstall]

Sign out first, so HQ revokes this computer's access, then remove the package.

```bash
hq logout
npm uninstall -g @aiworkforceoneofficial/hq
```

`hq` keeps its state in `~/.hq`. Delete it too if you want no trace left.

## Next [#next]

<Cards>
  <Card title="Sign in" href="/docs/cli/sign-in/">
    Approve this computer in HQ.
  </Card>

  <Card title="Attach to a session" href="/docs/cli/attach/">
    Follow an HQ session in your terminal.
  </Card>

  <Card title="Troubleshooting" href="/docs/cli/troubleshooting/">
    Fixes for install and path problems.
  </Card>
</Cards>
