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

# Run unattended

```bash theme={"dark"}
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
```

## Behaviour

* Questions take their default. Leaving the sandbox is refused, as is anything under `ask`.
* If the model loops on the same call, Humboldt tells it to wind down and write what is done, what remains and the next step.

## Events (`--json`)

`session.started`, `turn.started`, `message`, `tool.called`, `tool.result`, `hand_edit`, `compacted`, `wind_down`, `notice`, `session.finished`

## Exit codes

| Code | Meaning                     |
| ---- | --------------------------- |
| 0    | Done; verdict passed if any |
| 1    | Verdict failed              |
| 2    | Model failed                |
| 3    | Wound down                  |
| 4    | Out of turns or time        |

## Export

```bash theme={"dark"}
hum export <session> -o file.json             # ATIF trajectory
```
