CLI Reference
Complete reference for all NightShift commands. Every command is documented with flags, examples, and expected output.
nightshift solve
Run a full autonomous solve from a problem YAML file. This is the primary command for complex, multi-step problems. The system reads the YAML, queries the Knowledge Base, assembles a team via AR, executes, evaluates, and writes results.
| Flag | Default | Description |
|---|---|---|
| --bg | false | Run in background. Detaches immediately and returns the process ID. Monitor with nightshift status. |
| --dry-run | false | Simulate the run without making LLM calls. Shows the planned agent team and estimated cost. Useful for checking budget before committing. |
| --verbose | false | Print all agent messages to stdout in real time. Default behavior only shows summary lines. |
| --no-learn | false | Disable KB writes and AR updates for this run. Output is still produced. Use when testing or on sensitive data. |
nightshift run
Run a problem described in natural language. Shorter than solve — no YAML file needed. Useful for quick tasks. The system automatically generates acceptance criteria and budget estimates.
nightshift status
Show the current run state. Reads .nightshift/status.json and displays a human-readable summary. If no run is active, shows the last run's final state.
| Flag | Default | Description |
|---|---|---|
| --json | false | Output raw status.json content. Useful for scripting or piping to jq. |
| --watch | false | Continuously refresh every 2 seconds. Press Ctrl+C to stop. |
nightshift inject
Send a message to the running system. The message is appended to .nightshift/inbox.jsonl, which the Auditor reads. At the next replan, the Coordinator receives it as part of the Auditor's consolidated summary.
Your hint is treated with the same weight as an Investor signal — neither has a veto, but both influence the Coordinator's next plan. Messages are most effective during the replan phase between attempts.
nightshift stop
Send a graceful stop signal. Writes stop to .nightshift/control. The system finishes the currently running node, writes partial output if available, saves learning, and exits cleanly.
| Flag | Description |
|---|---|
| --force | Kill immediately without waiting for the current node. May produce incomplete output. Learning writes may be skipped. |
nightshift history
Show past runs with quality scores, costs, and outcomes. Reads from episodic memory in the KB. Useful for understanding how the system has improved over time.
nightshift kb
Manage the Knowledge Base directly. Subcommands: search, stats, clear.