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

# v0.5.0-rc.5

> 2026-05-05

Codex template enables `multi_agent_v2` with an 8-minute wait floor. `AGENTS.md` adds explicit `wait` tool rules. No new migrations.

## Enhancements

### Codex `multi_agent_v2` default-on

`.codex/config.toml` now writes the feature block instead of a commented-out hint:

```toml theme={null}
[features.multi_agent_v2]
enabled = true
max_concurrent_threads_per_session = 6
min_wait_timeout_ms = 480000
```

| Field                                | Value            | Note                                                                                           |
| ------------------------------------ | ---------------- | ---------------------------------------------------------------------------------------------- |
| `enabled`                            | `true`           | Required inside the table — the table form alone does NOT enable the feature                   |
| `max_concurrent_threads_per_session` | `6`              | Was `4`                                                                                        |
| `min_wait_timeout_ms`                | `480000` (8 min) | `wait()` timeout floor. Was `10000` (10 s). Forces the parent to wait through subagent runtime |

Project-level `[features]` activates only when the project is trusted. Add this to `~/.codex/config.toml`:

```toml theme={null}
[projects."/abs/path/to/your/repo"]
trust_level = "trusted"
```

### Drop legacy `codex_hooks = true`

`CodexHooks` is now `Stage::Stable` with `default_enabled: true` in Codex's feature registry, so `hooks.json` loads automatically once the project is trusted. The previous `[features].codex_hooks = true` line in the template was redundant and has been removed.

### `AGENTS.md` subagent wait rules

The Subagents section names Codex's `wait` tool and bans cancelling a subagent before it finishes:

* Wait for terminal status before yielding, acting on partial results, or spawning followups. On Codex, call `wait` with the thread id.
* Never cancel or re-spawn a subagent that hasn't finished. Raise the timeout (default 30 s, max 1 h) before judging it stuck.

## Upgrade

```bash theme={null}
npm install -g @mindfoldhq/trellis@rc
trellis update
```