niwaniwa0.1.2
saru-id/niwa
niwaniwa

niwa plan

Show what apply would do. Exit 0 when in sync, 2 when changes are pending, 1 on an error

niwa plan [--diff] [--json]

Flags

FlagArgumentMeaning
--diff—Render full file diffs, word-level highlighted
--json—The machine interface: one versioned JSON document

-v, --verbose and --debug are global and this verb takes them too. The global flags table lists them.

Exit codes

CodeWhen
0The machine is in sync
2Changes are pending
1An error

Screens

The screens below are snapshots the tool wrote, reproduced byte for byte.

 shell ─────────────────────────────
+ ~/.zshrc
 desktop ───────────────────────────
~ com.apple.dock autohide   false → true
~ 3 checked · 2 would change
niwa plan · tests/snapshots/snapshots__plan_pending_color.snap
3 resources · nothing to do
niwa plan · tests/snapshots/snapshots__plan_converged_piped.snap

Next

  • The apply loop — explain the three phases, the two passes, and the overwrite ladder
  • niwa pull — the next verb in this group

↑↓ navigate · enter opens · esc closes