Appearance
CLI Commands
Every subcommand exposed by np-tools.cjs, mirrored from bin/np-tools/_commands.cjs (the canonical registry). Categories match the workflow grouping.
Two dispatch layers exist:
init <workflow>— orchestrator workflows. Either calls a registered handler inbin/np-tools/<name>.cjs(plan-phase,discuss-phase,execute-phase,new-project, …) or composes a default phase payload viacomposeInit().- Top-level commands — utility/leaf commands (
commit-task,checkpoint,metrics,doctor,dispatch, …).
Output is JSON; payloads above 16 KB are spilled to .nubos-pilot/.tmp/init-<workflow>-<pid>-<rand>.json and the path emitted as @file:<path>.
Utility
| Command | Description |
|---|---|
next | Print the next actionable step |
progress | Report % complete across phases and plans |
state | Print the current project state snapshot |
help | List available commands |
init | Dispatcher init payload for workflows |
resolve-model | Resolve agent/tier to model alias or id |
metrics | Record JSONL metrics entry (record / now / start-timestamp / end-timestamp) |
askuser | Capability-layer prompt wrapper |
commit | Atomic git commit wrapper with gitignore-guard (D-21) |
config-get | Read value from .nubos-pilot/config.json by dotted key path |
generate-slug | Slugify text via lib/phase.cjs.phaseSlug |
phase | Phase utilities (next-decimal <base>) |
stats | Aggregated project stats (roadmap + STATE + git + metrics JSON shape) |
thread | Cross-session thread CRUD under .nubos-pilot/threads/ |
session-report | Generate session report from metrics since .last-session pointer |
cleanup | Archive completed milestones + collapse ROADMAP <details> block |
Planning
| Command | Description |
|---|---|
discuss-phase | Adaptive phase-context interview (writes CONTEXT.md) |
discuss-phase-power | Bulk gray-area question file-UI (power mode) |
research-phase | Optional phase-level research (WebFetch + MCP; offline fallback) |
plan-phase | Creates PLAN.md with plan-checker verification loop |
new-project | Greenfield project init (PROJECT + REQUIREMENTS + roadmap) |
new-milestone | Append milestone + first phase to an existing project |
plan-milestone-gaps | Create corrective phases from audit gaps |
agent-skills | Print agent_skills config for a given subagent |
plan-diff | Render two-part PLAN.md diff (semantic + git) |
ai-integration-phase | AI-SPEC generator with framework-selector + eval-planner |
ui-phase | UI-SPEC generator with researcher + checker revision loop |
Execution
| Command | Description |
|---|---|
execute-phase | Wave-based phase execution; emits per-task executor-spawn payloads |
execute-plan | Single-plan execution (sub-case of execute-phase) |
commit-task | Atomic per-task git commit via lib/git.cjs (D-03/D-25 enforced) |
checkpoint | Per-task checkpoint CRUD (start / transition / touch / show) |
autonomous | In-session gate snapshot for auto-advance loop (ADR-0001) |
verify-work | Two-pass goal-backward verification (D-21/D-22 VERIFICATION.md render/record) |
add-tests | Persist VERIFICATION Pass-cases as node:test UAT (Sentinel-preserving) |
pause-work | Stamp STATE.session.stopped_at + resume_file for explicit handoff |
resume-work | Classify session state (resume | orphan | clean) |
undo | Revert all task commits of a phase or plan via git revert |
undo-task | Revert a single task commit and reset task status to pending |
reset-slice | Restore working-tree files of the in-flight task; clear current_task |
skip | Mark task status skipped |
park | Mark task status parked |
unpark | Return a parked task to pending |
Review
| Command | Description |
|---|---|
code-review | Source-file review via np-code-reviewer — writes REVIEW.md sidecar |
code-review-fix | Auto-fix REVIEW.md findings via np-code-fixer (atomic commit per finding) |
review | Cross-AI peer review via 7-CLI fan-out |
secure-phase | Threat-mitigation audit via np-security-auditor |
validate-phase | Nyquist validation gap-fill via np-nyquist-auditor |
ui-review | 6-pillar retroactive UI audit |
eval-review | Retroactive eval-coverage audit |
Capture
| Command | Description |
|---|---|
add-todo | Capture pending todo to .nubos-pilot/todos/pending/ + bump STATE count |
note | Capture free-form note (--global writes to ~/.nubos-pilot/notes/) |
add-backlog | Append backlog item 999.x to ROADMAP.md + scaffold phase dir |
Install
| Command | Description |
|---|---|
doctor | 5-check install-integrity scan (--fix for auto-safe fixes) |
dispatch | State-router: compute next action and delegate via Skill() |
queue | Unified queue across todos / backlog / UAT / unplanned phases |
triage | Interactive per-item triage loop (promote / keep / drop) |