Nimi Coding Installation
Nimi Coding is distributed as the public npm package @nimiplatform/nimi-coding. Install it in the project where you want the .nimi/** governance layer and the nimicoding CLI.
Requirements
| Requirement | Notes |
|---|---|
| Node.js | 24 or newer |
| Package manager | npm, pnpm, yarn, or another tool that can install npm packages |
| Project root | A version-controlled project is recommended because start creates files |
Install
Use your project's package manager:
npm install --save-dev @nimiplatform/nimi-codingor:
pnpm add -D @nimiplatform/nimi-codingAfter installation, the project should have a nimicoding binary available through the package manager:
npx nimicoding --version
npx nimicoding --helpBootstrap
Run start from the project root:
npx nimicoding startIf you want the first prompt shaped for a specific host, use:
npx nimicoding start --host codex
npx nimicoding start --host claude
npx nimicoding start --host oh-my-codexFor a non-interactive smoke test, use:
npx nimicoding start --yes
npx nimicoding doctor --jsonstart creates or updates the package-owned bootstrap layer under .nimi/**, adds managed AI entrypoint blocks when you accept them, and prepares the next handoff payload. It preserves project-owned truth: .nimi/spec/**, .nimi/local/**, .nimi/cache/**, and locally modified bootstrap files are not silently deleted or overwritten.
First Checks
| Check | Expected result |
|---|---|
nimicoding --version | Prints the installed package version |
nimicoding --help | Lists bootstrap, sync, topic, sweep audit, sweep design, handoff, closeout, high-risk gates, and validators |
nimicoding doctor --json | Reports the bootstrap health state in machine-readable form |
To check package-owned seed projection later:
npx nimicoding sync --checkRemove Package-Managed Bootstrap
If you need to remove the package-managed bootstrap files from a test project, run:
npx nimicoding clear --yesclear removes managed AI blocks and package-owned bootstrap files only when they still match the packaged seed. It preserves project-owned truth and local operational evidence.