跳转到主要内容

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

​
Enhancements

​
Codex multi_agent_v2 默认开启

.codex/config.toml 从注释指引改为直接写入生效配置： 
[features.multi_agent_v2]
enabled = true
max_concurrent_threads_per_session = 6
min_wait_timeout_ms = 480000
字段值说明
enabledtrue表内必填——只写表不带这一行不会启用 feature
max_concurrent_threads_per_session6原值 4
min_wait_timeout_ms480000（8 分钟）wait() 超时下限。原值 10000（10 秒）。强制父 agent 等子 agent 跑完
项目级 [features] 只在项目被 trusted 时激活。在 ~/.codex/config.toml 加： 
[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

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