navori
快速开始

从零开始高效工作
只需四步。

本指南要求 Node 22.12+ 与已初始化的 git 仓库。如果已有手写的 .claude/,navori 可以共存并保留其内容。

安装 CLI

无需全局安装。使用日常习惯的 npx、pnpm dlx 或 bunx 即可。

# npm
npx navori init

# pnpm
pnpm dlx navori init

# bun
bunx navori init

回答向导

init 检测技术栈并询问必要信息,一分钟内生成 navori.config.json 和所选引擎的受管理 harness。没有官方预设?使用 `navori preset init <id>` 创建本地预设并自动接入配置。

? Wizard › English
→ stack: Next.js · pnpm
? Engines › claude, codex
? Preset › nextjs
? Plugins › engram, codegraph, tgrep

✓ navori.config.json
✓ rendered:
   CLAUDE.md · AGENTS.md
   .claude/  ·  agents · skills · hooks · settings
✓ Done — 34 created

提交并正常工作

navori.config.json 是唯一事实来源。受管理块有明确标记,其余内容由你管理。

$ git add navori.config.json CLAUDE.md .claude/
$ git commit -m "chore: bootstrap navori harness"

变化后重新渲染

add 在同一步自动渲染。手动编辑配置、切换预设等其他操作后,render 默认预览,--apply 才写入。sync 仅处理受管理块,保留自定义代码。

# Add a plugin (renders on its own)
$ npx navori add codegraph

# Upgrade to the latest version
$ npx navori@latest update

# Something drifted?
$ npx navori doctor