navori
navori

render

从 navori.config.json 幂等重建所有配置引擎,默认预览。

用法

navori render [--apply] [--force] [--workspace <name>] [--json] [--all [--prune] [--verbose]]

参数

--apply 写入磁盘;否则只预览,不触碰文件。
--force 即使 settings.json 损坏或缺少 $navori 标记也重新生成,先备份旧文件。
--workspace <name> 仅渲染指定 monorepo 工作区。
--dry-run 已弃用;预览已是默认行为,此参数作为显式别名。
--json 输出机器可读结果,抑制人类输出,适用于 CI 和自动化。
--all 渲染全局注册表 ~/.navori/registry.json 中的所有仓库;升级 navori 后可一次更新全部项目。
--prune --all 时先移除已不存在仓库的注册项;单仓库加 --apply 时,先备份再删除已从 config.engines 移除的引擎遗留输出。
--verbose --all 时逐仓库列出变化的受管理块,而非只显示数量。

示例

预览(默认)

$ navori render
  + CLAUDE.md  (created)
  + .claude/settings.json  (created)
  + .claude/agents/  (5)
Preview — 5 created · run 'navori render --apply' to write

应用

$ navori render --apply
Done — 5 created

注意事项

  • 默认预览,仅 --apply 才写入磁盘。
  • 仅重新生成 managed 标记之间的内容,保留标记之外的手写内容。
  • 还会写 .claude/.gitignore,启用 codex 时也写 .codex/.gitignore。任何 gitignoreHarness 模式下均以版本化块忽略 progress/、worktrees/、settings.local.json 等临时状态,保留引擎必需文件。