> ## 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.

# Sub-agents

> Hum delegates self-contained work to sub-agents that run beside the session on the same workspace. Define your own in `.hum/agents/`.

## Built in

| Kind | Tools |
| - | - |
| `explore` | Read-only: find things out |
| `general` | Everything: an independent piece of work, edits included |

The model chooses when to delegate. Several run at once, up to five. A sub-agent never asks you anything.

## Your own

One markdown file per agent under `.hum/agents/`, scanned recursively. Files in `.claude/agents/` and `.codex/agents/` are read the same way, and `~/.hum/agents/` holds your personal ones. The nearest file wins a name.

```markdown theme={"dark"}
---
name: code-reviewer
description: Reviews a change for correctness and style. Use after edits.
tools: read_file, grep, glob
maxTurns: 12
---
You are a reviewer. Report findings with file and line. Never edit.
```

| Field | Meaning |
| - | - |
| `name` | The kind the model delegates to. Defaults to the file name |
| `description` | When to use it. The model reads this to choose |
| `tools` | Allowlist: `read_file`, `write_file`, `edit_file`, `shell`, `grep`, `glob`, `web_fetch`, `web_search`. Claude Code's names are accepted |
| `disallowedTools` | Denylist |
| `maxTurns` | Ceiling for one run |
| `model` | Ignored. Every sub-agent runs on the route below |

The body is the agent's role, given to it whole. An agent whose tools can edit is refused while approvals are on.

```toml theme={"dark"}
[model]
agents = "deepseek-v4-flash"     # the route every sub-agent runs on; unset = the session's model
```


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