CLI Reference

Local Maintenance Commands

Inspect repository health and storage using the narrow command surface implemented by the current alpha.

Command	Current behavior	Usage
gc	Report unreachable-object candidates without deleting them	dits gc --dry-run
fsck	Verify local objects, references, commits, and refs	dits fsck [-v]
repo-stats	Show statistics for the current local repository	dits repo-stats [-v]
inspect-file	Inspect a tracked file and optionally list chunk IDs	dits inspect-file <PATH> [--chunks]
config	Read or update one selected TOML configuration file	dits config [OPTIONS] [KEY] [VALUE]

`dits gc`

Audits which Dits objects appear unreachable. The current implementation is report-only and does not reclaim disk space.

dits gc --dry-run

# Accepted but ignored in read-only mode
dits gc --dry-run --prune --aggressive

Destructive GC is disabled

Bare dits gc returns a nonzero error without changing objects or locks. --prune and --aggressive are reserved and ignored. Do not delete files manually from .dits/objects.

`dits fsck`

Reads the local object store, verifies BLAKE3 paths against stored bytes, follows manifest references to chunks, Git blobs, and MP4 structure blobs, validates regular-entry size/content identity, checks commits and refs, and checks commit-graph links. --verbose prints each check as it runs.

dits fsck
dits fsck --verbose

Detection, not repair

fsck has no --full, --strict, --repair, or JSON mode. It returns nonzero for integrity errors but does not fetch or reconstruct missing data. Recover from an independently verified backup.

`dits repo-stats`

Summarizes the current local commit, tracked logical bytes, locally stored bytes, and observed byte-identical chunk reuse. --verboseadds the implementation's per-file breakdown. Results describe this repository snapshot; they are not a general deduplication guarantee.

dits repo-stats
dits repo-stats --verbose

`dits inspect-file`

Looks up one tracked repository-relative path and reports its stored manifest and chunk information. --chunks lists the chunk identifiers. There is no current --shared or JSON option.

dits inspect-file footage/scene.mov
dits inspect-file footage/scene.mov --chunks

`dits config`

Reads or updates either .dits/config.toml or the platform-specific global file selected with --global. The current alpha selects one file; it does not merge a layered effective configuration.

# Read or set one repository-local value
dits config chunking.target_size
dits config chunking.target_size 128KB

# List the selected file
dits config --list

# Select the global file or remove an optional key
dits config --global telemetry.enabled false
dits config --global --unset user.email

Only documented keys are accepted. See the configuration reference and use dits <command> --help for parser-authoritative syntax.