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

dotling status

Show deployment status of all tracked entries.

Usage

dotling status [OPTIONS]

Options

FlagDescription
--diffShow inline diffs for modified copy entries

Description

dotling status displays the current state of each tracked entry, grouped by category. It checks whether each entry is properly deployed, up to date, or has issues.

Status indicators

StatusMeaning
DeployedEntry is correctly deployed and in sync
ModifiedEntry has local changes that differ from the repo
MissingTarget file is missing
BrokenSymlink points to a non-existent target
ConflictBoth repo and local file have changed

Sync badges

BadgeMeaning
[in sync]Repository and target match
[needs sync]One side has changed, run dotling sync
[diff]Content differs (shown with --diff)

Fingerprints

For copy-mode and encrypted entries, status checks use Blake2s-256 fingerprints stored in ~/.dotling/fingerprints.toml. This means you can check status without entering your vault password — it’s only needed when actual file modifications are required.

Examples

# Show status of all entries
dotling status

# Show inline diffs for modified entries
dotling status --diff