> ## 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 模板默认开启 `multi_agent_v2`，wait 超时下限 8 分钟。`AGENTS.md` 加上 `wait` 工具规则。无新增 migration。

## Enhancements

### Codex `multi_agent_v2` 默认开启

`.codex/config.toml` 从注释指引改为直接写入生效配置：

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

| 字段                                   | 值              | 说明                                                   |
| ------------------------------------ | -------------- | ---------------------------------------------------- |
| `enabled`                            | `true`         | 表内必填——只写表不带这一行不会启用 feature                           |
| `max_concurrent_threads_per_session` | `6`            | 原值 `4`                                               |
| `min_wait_timeout_ms`                | `480000`（8 分钟） | `wait()` 超时下限。原值 `10000`（10 秒）。强制父 agent 等子 agent 跑完 |

项目级 `[features]` 只在项目被 trusted 时激活。在 `~/.codex/config.toml` 加：

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

### 删掉 legacy `codex_hooks = true`

`CodexHooks` 在 Codex feature registry 里现在是 `Stage::Stable` 且 `default_enabled: true`——只要项目 trusted，`hooks.json` 自动加载。模板里之前的 `[features].codex_hooks = true` 是冗余的，已删除。

### `AGENTS.md` subagent wait 规则

Subagents 段点名 Codex 的 `wait` 工具，禁止在子 agent 跑完前 cancel：

* 等子 agent 进入终态再让出 / 处理结果 / 派发下一个。Codex 上调 `wait` 传 thread id。
* 子 agent 未完成时不要 cancel 或 re-spawn。觉得卡住先抬 timeout（默认 30 秒，上限 1 小时）再判断。

## Upgrade

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