Skip to main content

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.

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
FieldValueNote
enabledtrueRequired inside the table — the table form alone does NOT enable the feature
max_concurrent_threads_per_session6Was 4
min_wait_timeout_ms480000 (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