CLI reference
dither get
Read an entry by path or docid.
dither get <ref> [--lines start:end]Prints the body of a single indexed entry to stdout. Resolves either a display path (collection-relative, e.g. notes/auth.md) or a qmd docid (e.g. abc123). Refuses with the standard pre-init error until dither init has run.
Arguments
| Name | Description |
|---|---|
ref | Positional. Display path like notes/auth.md or docid like abc123. Required. |
Flags
| Flag | Description |
|---|---|
--lines <start:end> | 1-based inclusive line range. Either side may be omitted: --lines 10: reads from line 10 to EOF; --lines :20 reads the first 20 lines. |
Examples
Whole file:
dither get notes/auth.mdBy docid (taken from a dither search hit):
dither get abc123Lines 10 through 30:
dither get notes/auth.md --lines 10:30First 20 lines:
dither get notes/auth.md --lines :20Notes
- Reads through the index, not the filesystem — an entry only resolves once
dither index update(or the daemon) has picked it up. - If the ref doesn't resolve — or no collections exist yet — the command prints nothing and exits successfully. There is no "not found" error.
- Output is the stored markdown body of the document.
See also: CLI overview, dither search.