CLI reference
dither status
Summarize the dither install.
dither status
dither status --jsonPrints where dither is installed, library health, plugin/collection/entry counts, and daemon state. Works before dither init — the library line reports "not configured" and content counts show — instead of numbers.
Arguments
| Flag | Effect |
|---|---|
--json | Emit structured JSON instead of human-readable text. |
Output
config dir: ~/.dither
library: ~/.dither/library
plugins: 2
collections: 3
entries: 142
daemon: idle (pid 14675)| Line | Meaning |
|---|---|
config dir | Resolved config dir ($DITHER_DIR → $XDG_CONFIG_HOME/dither → ~/.dither). When $DITHER_DIR is set, a Note: Using ENV DITHER_DIR=… header is printed above. |
library | Configured library path (default $DITHER_DIR/library), or (not configured — run dither init). Annotated ⚠ missing / ⚠ unreadable if the directory is gone or not readable. |
plugins | Number of grants files under <config-dir>/grants/ (one per installed plugin). |
collections | Collections known to the index. — if library is unconfigured / missing / unreadable. |
entries | Documents known to the index. — if library is unconfigured / missing / unreadable. |
daemon | idle (pid N), running (pid N, K plugin[s]), running (pid N) if no snapshot, or not running (with the probe reason). A dim status updated <ago> line follows when a snapshot exists. |
When indexing or embedding work is in flight — or recently finished — extra lines follow: current: for the running job (with progress and elapsed time), recent: for the last few finished jobs (✓ done, ⚠ failed, ⊘ skipped), plus needs-reindex pending and embed-disabled markers. The block is omitted entirely when there's nothing to report.
The counts come from the qmd index, not a filesystem walk, so they lag disk until the index catches up. Run dither index update to refresh it.
See also: CLI overview.