v0.5.0-rc.5 - Trellis Doc

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:

[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:

[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

npm install -g @mindfoldhq/trellis@rc
trellis update