Skip to content
Dotweave Dotweave v0.39.7

dotweave track

Register local files or directories for syncing.

Track local files or directories for syncing.

Register one or more files or directories inside your home directory so dotweave can mirror them into the sync directory. If a target is already tracked, its mode is updated. Targets may also be repository paths inside a tracked directory to create child entries with a specific mode.

dotweave track <targets...> [flags]
ArgumentDescription
<targets...>One or more local paths or repository paths to track.
FlagDescription
--mode <mode>Sync mode: normal (default), secret, or ignore.
--profiles <names>Restrict syncing to specific profiles (comma-separated).
--repoPath <path>Repository-relative path under the profile directory.
--verboseShow detailed output.

Track a single config file:

dotweave track ~/.config/starship.toml

Track a directory containing secrets:

dotweave track ~/.ssh --mode secret

Track a file restricted to a specific profile:

dotweave track ~/.config/work-proxy.conf --profiles work

Override the mode for a child path inside a tracked directory:

dotweave track .ssh/config --mode ignore