dotweave track
Register local files or directories for syncing.
Track local files or directories for syncing.
Register a file or directory inside your home directory so dotweave can mirror it into the sync directory. If the target is already tracked, specified manifest fields are updated and unspecified fields are preserved.
dotweave track <target> [flags]Arguments
Section titled “Arguments”| Argument | Description |
| ---------- | -------------------------------------------- |
| <target> | Local path or repository path to track. |
| Flag | Description |
| -------------------------------- | ---------------------------------------------------------------------------- |
| --kind <file\|directory> | Target kind to use when the path does not exist yet. |
| --repo <path\|platform=path> | Repository-relative path, with optional platform overrides. |
| --local <platform=path> | Platform-specific local path override. |
| --mode <mode\|platform=mode> | Sync mode: normal (default), secret, or ignore. |
| --permission <octal\|platform=octal> | File permission to restore, as a 4-character octal value. |
| --profile <profile> | Restrict syncing to a registered profile. Repeat for multiple profiles. |
Examples
Section titled “Examples”Track a single config file:
dotweave track ~/.config/starship.tomlTrack a directory containing secrets:
dotweave track ~/.ssh --mode secretTrack a file restricted to a specific profile:
dotweave track ~/.config/work-proxy.conf --profile workOverride the mode for a child path inside a tracked directory:
dotweave track .ssh/config --mode ignoreCustomize the repository path and restore permission:
dotweave track ~/.ssh/config --repo ssh/config --mode secret --permission 0600