Quickstart

1. Install

macOS (Apple silicon) and Linux:

curl -fsSL https://hum.metaphi.ai/install.sh | sh

Windows (PowerShell):

irm https://hum.metaphi.ai/install.ps1 | iex

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

npm install -g @metaphi-ai/hum
uv tool install hum-cli

Check it:

hum --version

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

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

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.

Sessions
In a session
Project instructions

⌘I

Getting started

Use Humboldt

Build with Humboldt

Reference

1. Install

3. Run a task

Update

Next

​1. Install

​2. Sign in

​3. Run a task

​Update

​Next

1. Install

2. Sign in

3. Run a task

Update

Next