# Hum docs

> Hum is a self-improving coding agent for the terminal, built for long-running async work. Each link is one page as markdown; /llms-full.txt is every page in one file. These pages describe the latest release; `hum --version` says which one you run.

## Getting started

- [Overview](https://humboldt.metaphi.ai/docs/overview.md): Hum is a self-improving coding agent for your terminal. Built for long-running async work.
- [Quickstart](https://humboldt.metaphi.ai/docs/quickstart.md): Install, sign in, run a task. About two minutes.

## Use Hum

- [Sessions](https://humboldt.metaphi.ai/docs/sessions.md): A session is its own process. It outlives the terminal.
- [Steer the work](https://humboldt.metaphi.ai/docs/steering.md): ## While it works
- [When it asks you](https://humboldt.metaphi.ai/docs/asks.md): ## Questions
- [Sandbox and approvals](https://humboldt.metaphi.ai/docs/sandbox.md): Commands and file edits run in a local sandbox. Leaving it asks first.
- [Models and credits](https://humboldt.metaphi.ai/docs/models.md): ## Routed models

## Build with Hum

- [Project instructions](https://humboldt.metaphi.ai/docs/instructions.md): Tell Hum how this repository works in an AGENTS.md at the repository root. Hum reads it at the start of every session.
- [MCP servers](https://humboldt.metaphi.ai/docs/mcp-servers.md): Tool servers give Hum abilities beyond the machine. The ones your account comes with connect at sign-in. Add your own in a few lines.
- [Agent teams](https://humboldt.metaphi.ai/docs/agent-teams.md): A lead session that splits a job into pieces, hands each to a worker session, and keeps them in sync.
- [Sub-agents](https://humboldt.metaphi.ai/docs/sub-agents.md): Hum delegates self-contained work to sub-agents that run beside the session on the same workspace. Define your own in .hum/agents/.
- [Skills](https://humboldt.metaphi.ai/docs/skills.md): A directory with a SKILL.md. Hum loads one when the task matches.
- [Hooks](https://humboldt.metaphi.ai/docs/hooks.md): A command Hum runs at a point in the loop. It can block. Claude Code and Codex hook files run unchanged.
- [Run unattended](https://humboldt.metaphi.ai/docs/unattended.md): bash hum run "task" hum run "task" --json                         # one JSON object per line hum run "task" --output-last-message out.md hum run "task" -C DIR --image shot.png 
- [Personas](https://humboldt.metaphi.ai/docs/personas.md): A simulated person at the terminal. It drives a normal session on a scenario, so a harness change is measured before a person meets it.

## Reference

- [Commands](https://humboldt.metaphi.ai/docs/commands.md): Bare hum opens a session in the current directory.
- [In a session](https://humboldt.metaphi.ai/docs/in-a-session.md): /help shows this list in the terminal.
- [Configuration](https://humboldt.metaphi.ai/docs/configuration.md): Nothing is required. ~/.hum/config.toml is yours; <repo>/.hum/config.toml is the project's.
- [Troubleshooting](https://humboldt.metaphi.ai/docs/troubleshooting.md): Start with hum doctor. It checks the install, the launcher, PATH, the sandbox and the sign-in without starting a session. hum doctor --json for a support thread.