getting-started.md

Getting started

Install locally:

pip install -e .[dev]
nexu --help

Create nexu metadata in a project:

nexu init .

Freeze a baseline:

nexu freeze . --name baseline

Create a capsule from a small slice:

nexu capsule create . \
  --name menu-icons \
  --domain menu \
  --route /connect-menu-editor/icon-normalization \
  --endpoint POST:/api/v3/menu/icons/normalize/preview \
  --include "frontend/src/modules/connect-menu-editor/**" \
  --include "backend/app/cqrs/menu/**" \
  --include "contracts/*Menu*"

Generate a deterministic 10-step plan:

nexu capsule plan menu-icons --steps 10 --goal "Evolve menu icon preview and apply flow"

Generate a lightweight future-preview blueprint:

nexu capsule blueprint menu-icons --print

Create iteration folders and prompts:

nexu capsule iterate menu-icons --steps 10 --goal "Evolve menu icon preview and apply flow"

Build a static runtime/mock that can be opened in the browser:

nexu capsule runtime menu-icons

Open:

.nexu/capsules/menu-icons/runtime/index.html

Export an LLM-ready prompt for the current iteration:

nexu capsule export-prompt menu-icons

Verify:

nexu capsule verify menu-icons

Generate the review report:

nexu capsule report menu-icons

Check local capsule changes and source drift:

nexu capsule diff menu-icons
nexu capsule drift menu-icons

Promote after review:

nexu capsule promote menu-icons --dry-run