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

# Quickstart

> Install, sign in, run a task. About two minutes.

## 1. Install

macOS (Apple silicon) and Linux:

```bash theme={"dark"}
curl -fsSL https://hum.metaphi.ai/install.sh | sh
```

Windows (PowerShell):

```powershell theme={"dark"}
irm https://hum.metaphi.ai/install.ps1 | iex
```

npm or uv (any platform, including managed Windows machines):

```bash theme={"dark"}
npm install -g @metaphi-ai/hum
uv tool install hum-cli
```

Check it:

```bash theme={"dark"}
hum --version
```

## 2. Sign in

```bash theme={"dark"}
hum login
```

The browser opens. Sign in with Google or GitHub and confirm the code shown in the terminal. Once per machine.

## 3. Run a task

```bash theme={"dark"}
cd your-repo
hum "make the nightly job idempotent"
```

While it works:

| Do             | Effect                           |
| -------------- | -------------------------------- |
| Type           | Steer it                         |
| `esc`          | Stop the turn, keep the work     |
| `ctrl+c` twice | Leave. The session keeps running |
| `hum resume`   | Come back                        |

## Update

```bash theme={"dark"}
hum update
```

When a newer release is out, Humboldt asks at start: update now (it installs and starts again on the new version), not now (it installs in the background and takes effect next time), or skip this version. `HUM_NO_AUTO_UPDATE=1` keeps the question and stops the background install; `HUM_NO_UPDATE_CHECK=1` turns it all off.

## Next

* [Sessions](/sessions)
* [In a session](/in-a-session)
* [Project instructions](/instructions)