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

# Overview

> Hum is a self-improving coding agent for your terminal. Built for long-running async work.

## Install

```bash theme={"dark"}
curl -fsSL https://hum.metaphi.ai/install.sh | sh   # macOS, Linux
irm https://hum.metaphi.ai/install.ps1 | iex        # Windows
npm install -g @metaphi-ai/hum                      # any platform
```

## Start

```bash theme={"dark"}
cd your-repo
hum
```

The first run signs you in. See the [Quickstart](https://docs.metaphi.ai/hum/quickstart.md).

## What it does

* Plans, edits files, runs commands in a local sandbox.
* Keeps working after you close the terminal. `hum resume` brings you back.
* Asks you when a decision is yours. Away, it takes the default and the question waits.
* Runs unattended with `hum run "task"`.
* Reads `AGENTS.md` at the root and in any folder, plus skills, hooks, MCP servers and plugins you already have.
* Runs on the models we route or on a host you name.
* Knows its own docs. Ask it what it can do or how a setting works; it reads these pages before answering.

## Next

* [Quickstart](https://docs.metaphi.ai/hum/quickstart.md)
* [Sessions](https://docs.metaphi.ai/hum/sessions.md)
* [Commands](https://docs.metaphi.ai/hum/commands.md)
* [In a session](https://docs.metaphi.ai/hum/in-a-session.md)
* [Troubleshooting](https://docs.metaphi.ai/hum/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.