navori AI harness
Quickstart

From zero to productive
in four steps.

This guide assumes Node 20+ and an initialized git repo. If you already have a hand-rolled .claude/, navori coexists without overwriting it.

Install the CLI

No global install required. Use npx, pnpm dlx, or bunx — whatever you use day-to-day.

# npm
npx navori init

# pnpm
pnpm dlx navori init

# bun
bunx navori init

Answer the wizard

init detects your stack and asks a few questions. In under a minute you get navori.config.json + the managed harness for the engines you picked. No official preset for your stack? Scaffold a local one with `navori preset init <id>` — it's wired into the config.

? 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

Commit and work as usual

navori.config.json is the single source of truth. Managed blocks are clearly marked — everything else is yours.

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

Re-render whenever you change something

Add plugins or bump the version. render previews by default; --apply writes. sync only touches managed blocks; your custom code is left alone.

# Add a plugin
$ npx navori add codegraph
$ npx navori render --apply

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

# Something drifted?
$ npx navori doctor