Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Repository Status

prikk status

Unlike most other commands, status takes no path or --ref argument: it always reports on the repository rooted at the current working directory, using its default active-session WAL.

For each invocation, the CLI reports:

  • the repository’s .prikk directory path;
  • the number of active (unsealed) WAL records, and any trailing partial bytes from an interrupted append;
  • heads/main’s current RefState ID, specifically — not whichever ref the active queue is targeting, which is reported separately;
  • the queued-patch count and the ref it targets, when the queue is non-empty;
  • a warning once the queued-patch count reaches the recommended threshold or the configured hard limit (PRIKK_ACTIVE_PATCH_WARN/PRIKK_ACTIVE_PATCH_LIMIT; see NFR-PERF-02), the same thresholds prikk commit enforces on the write path.

status does not run verify’s integrity checks, and does not report the worktree’s own divergence from the replay baseline — that is worktree-status. Multi-operation text diff minimization and audit plugins are not yet implemented; the command’s own trailing line notes this.