Trellis v0.4.0 正式发布！原生 Monorepo 支持 + codex 满血支持 + 多个新平台！
- 内容介绍
- 文章标签
- 相关推荐
经过 11 个 beta + 2 个 rc，Trellis v0.4.0 稳定版正式发布！
Monorepo 原生支持
trellis init 现在会识别 monorepo，按包创建独立的 spec 目录，每个 package 都能有自己的一套编码规范和任务。配套地，9 个平台上的 before-backend-dev / before-frontend-dev / check-backend / check-frontend 合并成了通用的 before-dev / check，命令矩阵不会因为 package 数量爆炸。
平台支持更多
- GitHub Copilot —
--copilot - Windsurf —
--windsurf - Qoder —
--qoder - Factory Droid —
--droid
例如同时启用多个平台：
trellis init --codex --gemini --copilot -u your-name
Codex 满血支持
- 启用了 Codex 的 SessionStart hook：现在 Codex 用户可以跟 Claude Code 用户一样，无需再手动调用
/start命令，启动 session 就能直接对话，task 状态、workflow、guidelines 自动注入 - 支持了 sub-agent 的定义：
.codex/agents/下新增 TOML 格式的implement/research/checkagent，跟 Claude Code 的Agent工具语义对齐 - shared skills 共享层：Codex 写入
.agents/skills/（agentskills.io 标准目录），同一份输出会被 Cursor、Gemini CLI、GitHub Copilot、Amp、Kimi Code 自动读取——勾一个 Codex 选项覆盖一大片工具链
其他改进
- 自定义 spec 模板 Registry：
trellis init -r <source>从自定义 git 仓库（GitHub / GitLab / Bitbucket，含自托管 GitLab 的 HTTPS / SSH）拉 spec 模板，而不是从默认 marketplace 拉。团队可以把自家编码规范维护在内网 git 服务器上分发 - 重新 init 的快速路径：
trellis init --codex在已有项目里追加配置 Codex；不带参数会弹菜单 - 分支感知：session 和 journal 带上 git 分支上下文，多分支并行不混乱
- Claude Code Statusline 集成
- 多 Agent 流水线：支持 worktree submodule 和 PR 状态追踪
关键修复
- SessionStart 瘦身：从约 29 KB 缩到约 7 KB，修了一个会让 Claude Code 静默截断 task 状态的大坑
- Windows：statusline GBK 编码崩溃（感谢 @xiangagou163）、Codex
hooks.json的{{PYTHON_CMD}}占位符解析
其他修复（节选）
- fix(update): rename 迁移允许指向受保护路径 + 配置解析失败时告警
- fix(update): 创建迁移任务时从
.developer解析名字 - fix(hooks): 跨平台规范化
.current-task路径引用（#130） - fix(hooks): ralph-loop 的
SubagentStop事件字段名（#152） - fix(opencode): dispatch 等待子任务（#147）
- fix(init): monorepo 包目录去掉 npm scope 前缀
- fix(init): 模板选择器把 “empty templates” 改成 “from scratch”
- fix(scripts):
start.py保留 submodule 的 status 前缀
安装与升级
# 新装
npm install -g @mindfoldhq/trellis@latest --registry=https://registry.npmjs.org
# 升级（已装过 trellis）
trellis update
从 0.3.x 升级会自动处理 36 个命令文件的合并——带 hash 校验，你的本地修改会被保留，没被改过的文件才删。
完整 changelog：https://mindfoldhq.com/changelog/v0.4.0
repo: GitHub - mindfold-ai/Trellis: The best agent harness. · GitHub
doc: Trellis - Trellis Doc
--【壹】--：
要手动初始化吗？不能命令AI引导生成吗？
--【贰】--：
我们后面跟进一下cursor 相关的适配
--【叁】--：
有个问题 trellis update 时显示 Error: Trellis not initialized in this directory 。不能全局更新吗。我只能到每个项目下执行都执行一遍？安装是全局安装。
--【肆】--：
我们有支持 monorepo 了，可以尝试下
--【伍】--：
前排前排，太强了佬，终于更新了，下午就去体验下
--【陆】--：
手动 trellis init 一下，然后就 ok 了，没啥很复杂的流程
--【柒】--：
Cursor也有hooks，现在能支持吗
--【捌】--：
很早就关注了这个项目，也已经安装了，不知道有没有特殊技巧，这个名字实在是太难记住了，以至于我安装后没有运行过～希望大佬能否告知下技巧，感谢
--【玖】--：
目前版本是需要按照项目去 init，update 的，目前还没做全局安装的机制（cli 是全局安装的，但是每个项目还需要再生成 .trellis 目录去初始化）
全局安装会在 0.5.0 相关进行设计
--【拾】--：
是时候删除气人的superpowet了！！？
--【拾壹】--：
非git目录有支持吗，就是前后端本地拉取在一个目录但是其实是两个git仓库。
--【拾贰】--：
支持，另外发现文档的定制 Slash 命令和定制 Agent的md格式有问题，代码超出到外面成副标题了。
定制 Slash 命令 - Trellis Doc
--【拾叁】--：
佬，这个和codex，cc、opencode的区别是啥啊
--【拾肆】--：
可以看看这个项目吗？
[开源]（4.9更新）我整合了340+个skills，19+个高星vibecoding项目到一个智能路由治理skills包中。 开发调优本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容： 我的帖子已经打上 开源推广 标签： 是 我的开源项目完整开源，无未开源部分： 是 我的开源项目已链接认可 LINUX DO 社区： 是 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是 以上选择我承诺是永久有效的，接受社区和佬友监督： 是 以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出 首先要感谢各…
--【拾伍】--：
从3.0开始使用完成了很多之前想做没做成的事情，感谢佬友！
--【拾陆】--：
支持。一直在用。还是很不错的。轻量又好用
--【拾柒】--： 桃酥:
启用了 codex 的 session start 的 hook，现在 codex 用户可以跟 cc 用户一样，无需再手动调用 /start 命令，而是可以直接对话
codex用户狂喜
支持佬友，正在后台用trellis鞭策codex开发
--【拾捌】--：
可以参考下这个 qa 的帖子 ，有介绍快速上手使用
对于 Trellis 框架的 Q & AQ: 看着很好用但理念听起来很复杂,怎么快速上手使用?
A: npm install -g @mindfoldhq/trellis@latest, 在你的项目下面 用 tl init 进行初始化, 然后就可以直接开始使用了,
--【拾玖】--：
佬，向你提一个问题，我在 Blog 看到 trellis 是有内置 Agent 系统的，但是我实际使用时感觉他们的存在感似乎不是很强，我想知道是不是我的使用上的问题导致没有利用到这些内置 Agent ?
日常使用就是下面这几个 command
/trellis:brainstorm
/trellis:start → /trellis:finish-work → /trellis:record-session
/trellis:check-backend
/trellis:update-spect
常见冒头的 agent 就是 check/implement/research
image817×650 63.5 KB
经过 11 个 beta + 2 个 rc，Trellis v0.4.0 稳定版正式发布！
Monorepo 原生支持
trellis init 现在会识别 monorepo，按包创建独立的 spec 目录，每个 package 都能有自己的一套编码规范和任务。配套地，9 个平台上的 before-backend-dev / before-frontend-dev / check-backend / check-frontend 合并成了通用的 before-dev / check，命令矩阵不会因为 package 数量爆炸。
平台支持更多
- GitHub Copilot —
--copilot - Windsurf —
--windsurf - Qoder —
--qoder - Factory Droid —
--droid
例如同时启用多个平台：
trellis init --codex --gemini --copilot -u your-name
Codex 满血支持
- 启用了 Codex 的 SessionStart hook：现在 Codex 用户可以跟 Claude Code 用户一样，无需再手动调用
/start命令，启动 session 就能直接对话，task 状态、workflow、guidelines 自动注入 - 支持了 sub-agent 的定义：
.codex/agents/下新增 TOML 格式的implement/research/checkagent，跟 Claude Code 的Agent工具语义对齐 - shared skills 共享层：Codex 写入
.agents/skills/（agentskills.io 标准目录），同一份输出会被 Cursor、Gemini CLI、GitHub Copilot、Amp、Kimi Code 自动读取——勾一个 Codex 选项覆盖一大片工具链
其他改进
- 自定义 spec 模板 Registry：
trellis init -r <source>从自定义 git 仓库（GitHub / GitLab / Bitbucket，含自托管 GitLab 的 HTTPS / SSH）拉 spec 模板，而不是从默认 marketplace 拉。团队可以把自家编码规范维护在内网 git 服务器上分发 - 重新 init 的快速路径：
trellis init --codex在已有项目里追加配置 Codex；不带参数会弹菜单 - 分支感知：session 和 journal 带上 git 分支上下文，多分支并行不混乱
- Claude Code Statusline 集成
- 多 Agent 流水线：支持 worktree submodule 和 PR 状态追踪
关键修复
- SessionStart 瘦身：从约 29 KB 缩到约 7 KB，修了一个会让 Claude Code 静默截断 task 状态的大坑
- Windows：statusline GBK 编码崩溃（感谢 @xiangagou163）、Codex
hooks.json的{{PYTHON_CMD}}占位符解析
其他修复（节选）
- fix(update): rename 迁移允许指向受保护路径 + 配置解析失败时告警
- fix(update): 创建迁移任务时从
.developer解析名字 - fix(hooks): 跨平台规范化
.current-task路径引用（#130） - fix(hooks): ralph-loop 的
SubagentStop事件字段名（#152） - fix(opencode): dispatch 等待子任务（#147）
- fix(init): monorepo 包目录去掉 npm scope 前缀
- fix(init): 模板选择器把 “empty templates” 改成 “from scratch”
- fix(scripts):
start.py保留 submodule 的 status 前缀
安装与升级
# 新装
npm install -g @mindfoldhq/trellis@latest --registry=https://registry.npmjs.org
# 升级（已装过 trellis）
trellis update
从 0.3.x 升级会自动处理 36 个命令文件的合并——带 hash 校验，你的本地修改会被保留，没被改过的文件才删。
完整 changelog：https://mindfoldhq.com/changelog/v0.4.0
repo: GitHub - mindfold-ai/Trellis: The best agent harness. · GitHub
doc: Trellis - Trellis Doc
--【壹】--：
要手动初始化吗？不能命令AI引导生成吗？
--【贰】--：
我们后面跟进一下cursor 相关的适配
--【叁】--：
有个问题 trellis update 时显示 Error: Trellis not initialized in this directory 。不能全局更新吗。我只能到每个项目下执行都执行一遍？安装是全局安装。
--【肆】--：
我们有支持 monorepo 了，可以尝试下
--【伍】--：
前排前排，太强了佬，终于更新了，下午就去体验下
--【陆】--：
手动 trellis init 一下，然后就 ok 了，没啥很复杂的流程
--【柒】--：
Cursor也有hooks，现在能支持吗
--【捌】--：
很早就关注了这个项目，也已经安装了，不知道有没有特殊技巧，这个名字实在是太难记住了，以至于我安装后没有运行过～希望大佬能否告知下技巧，感谢
--【玖】--：
目前版本是需要按照项目去 init，update 的，目前还没做全局安装的机制（cli 是全局安装的，但是每个项目还需要再生成 .trellis 目录去初始化）
全局安装会在 0.5.0 相关进行设计
--【拾】--：
是时候删除气人的superpowet了！！？
--【拾壹】--：
非git目录有支持吗，就是前后端本地拉取在一个目录但是其实是两个git仓库。
--【拾贰】--：
支持，另外发现文档的定制 Slash 命令和定制 Agent的md格式有问题，代码超出到外面成副标题了。
定制 Slash 命令 - Trellis Doc
--【拾叁】--：
佬，这个和codex，cc、opencode的区别是啥啊
--【拾肆】--：
可以看看这个项目吗？
[开源]（4.9更新）我整合了340+个skills，19+个高星vibecoding项目到一个智能路由治理skills包中。 开发调优本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容： 我的帖子已经打上 开源推广 标签： 是 我的开源项目完整开源，无未开源部分： 是 我的开源项目已链接认可 LINUX DO 社区： 是 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是 以上选择我承诺是永久有效的，接受社区和佬友监督： 是 以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出 首先要感谢各…
--【拾伍】--：
从3.0开始使用完成了很多之前想做没做成的事情，感谢佬友！
--【拾陆】--：
支持。一直在用。还是很不错的。轻量又好用
--【拾柒】--： 桃酥:
启用了 codex 的 session start 的 hook，现在 codex 用户可以跟 cc 用户一样，无需再手动调用 /start 命令，而是可以直接对话
codex用户狂喜
支持佬友，正在后台用trellis鞭策codex开发
--【拾捌】--：
可以参考下这个 qa 的帖子 ，有介绍快速上手使用
对于 Trellis 框架的 Q & AQ: 看着很好用但理念听起来很复杂,怎么快速上手使用?
A: npm install -g @mindfoldhq/trellis@latest, 在你的项目下面 用 tl init 进行初始化, 然后就可以直接开始使用了,
--【拾玖】--：
佬，向你提一个问题，我在 Blog 看到 trellis 是有内置 Agent 系统的，但是我实际使用时感觉他们的存在感似乎不是很强，我想知道是不是我的使用上的问题导致没有利用到这些内置 Agent ?
日常使用就是下面这几个 command
/trellis:brainstorm
/trellis:start → /trellis:finish-work → /trellis:record-session
/trellis:check-backend
/trellis:update-spect
常见冒头的 agent 就是 check/implement/research
image817×650 63.5 KB