CLI Reference

dotling is organized as a set of subcommands. Each command has its own page with detailed usage, flags, and examples.

Commands

Command	Description
dotling init	Initialize a new repo or clone an existing one
dotling add	Move files into the repo and deploy symlinks/copies
dotling remove	Untrack entries and restore files to original locations
dotling sync	Bidirectional sync between repo and actual filesystem
dotling status	Show deployment status of all tracked entries
dotling edit	Edit a tracked entry in `$EDITOR`
dotling encrypt	Encrypt tracked entries
dotling decrypt	Decrypt encrypted entries
dotling vault	Manage the encryption vault
dotling doctor	Audit repository health
dotling vars	Manage machine-local template variables
dotling completions	Generate shell completion scripts

Global flags

Flag	Description
`-v, --verbose`	Show hints and additional details
`-h, --help`	Print help
`-V, --version`	Print version

Key command flags

Command	Flag	Description
`add`	`--copy`	Deploy as a copy instead of a symlink
`add`	`--encrypt`	Encrypt the file(s) using the vault password
`add`	`--template`	Track as a template: rendered on each sync
`add`	`--os <platform>`	Target OS: `linux`, `macos`, `windows`
`sync`	`--dry-run`	Preview changes without modifying anything
`sync`	`--force`	Overwrite conflicting files (repo wins)
`sync`	`--prefer-actual`	Prefer the local file on conflict
`sync`	`--no-interactive`	Skip conflicts, print warnings
`sync`	`--allow-hooks`	Execute all hooks without prompting
`sync`	`--no-hooks`	Disable all hook execution
`status`	`--diff`	Show inline diffs for modified copy entries