# Humboldt

> Humboldt documentation. Install, run a session, steer the work, build with plugins, tool servers and language servers.

- [Overview](https://humboldt.metaphi.ai/docs/overview.md): Humboldt 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.
- [Sessions](https://humboldt.metaphi.ai/docs/sessions.md): A session is its own process. It outlives the terminal.
- [Humboldt in Slack](https://humboldt.metaphi.ai/docs/slack.md): Install the app, invite it to a channel, connect the repository, and hand it the first task without a terminal.
- [Steer the work](https://humboldt.metaphi.ai/docs/steering.md)
- [When it asks you](https://humboldt.metaphi.ai/docs/asks.md)
- [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)
- [Project instructions](https://humboldt.metaphi.ai/docs/instructions.md): Tell Humboldt how this repository works in an `AGENTS.md` at the repository root. Humboldt reads it at the start of every session.
- [Plugins](https://humboldt.metaphi.ai/docs/plugins.md): A plugin is a directory that bundles skills, agents, hooks, tool servers and language servers. Humboldt reads the layout Claude Code's plugins use, unchanged, so a plugin written for either works in both.
- [MCP servers](https://humboldt.metaphi.ai/docs/mcp-servers.md): Tool servers give Humboldt abilities beyond the machine. The ones your account comes with connect at sign-in. Add your own in a few lines.
- [Language servers](https://humboldt.metaphi.ai/docs/language-servers.md): Humboldt reads the code the way the compiler does when a language server is there: where a symbol is defined, who references it, what a name is, what the parser complains about.
- [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): Humboldt 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`. Humboldt loads one when the task matches.
- [Hooks](https://humboldt.metaphi.ai/docs/hooks.md): A command Humboldt 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)
- [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.
- [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.