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 dither home ($DITHER_DIR → $XDG_CONFIG_HOME/dither → $DITHER_HOME → ~/.dither). When $DITHER_DIR is set, a Note: Using ENV DITHER_DIR=… header is printed above. |
library | Configured library path, or (not configured — run dither init). Annotated ⚠ missing / ⚠ unreadable if the directory is gone or not readable. |
plugins | Number of grants files under <dither-home>/grants/ (one per installed plugin). |
collections | Number of top-level directories under the configured library. — if library is unconfigured / missing / unreadable. |
entries | Recursive count of *.md files under the configured library. — 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. |
This is a filesystem walk, not an index lookup, so the counts reflect what's on disk regardless of whether the qmd index is up to date. To make the index match what status reports, run dither index update.
See also: CLI overview.