dotweave untrack
Remove a tracked entry or a nested override from the manifest, and delete its repository artifacts.
Synopsis
dotweave untrack <target>Drop one record from manifest.jsonc and clear what that record wrote into the sync directory.
Arguments
| Argument | Type and default | Purpose |
|---|---|---|
target | string, required | Tracked local path (including cwd-relative) or repository path to stop tracking. |
Behavior
untrack writes the manifest without the matching entry, then deletes that entry's plain, secret, and symlink artifacts under every profile directory it occupied, pruning parent directories that become empty. The command's own --help text says it only updates the sync config; that is wrong. The artifacts are already gone when the command returns.
The local file under your home directory is not touched. Your config stays exactly where it is, and only the mirrored copy in the sync directory disappears.
Pass a local path to remove the main tracked entry. Pass a repository-relative child path inside a tracked directory to remove only that nested override, which leaves the parent entry tracked.
A target that matches more than one entry fails instead of guessing. Pass the full local path to choose between them.
dotweave untrack ~/.gitconfig✔ Stopped tracking .gitconfig
plain: 1
secret: 0The two counts report how many plain and secret artifacts were removed.
untrack deletes the repository artifacts for the entry immediately, in every profile. The local file under your home directory is left alone, but the mirrored copy and its history-ready content are removed from the sync directory. Commit the deletion so other devices stop restoring the file.
Errors
An empty target reports Target path is required., and an unknown one reports No tracked sync entry matches: <target>. Neither carries an error code or a hint. An ambiguous target reports Multiple tracked sync entries match: <target> with the hint to use an explicit local path. Read Error messages for each message and its fix.
Related commands
Read dotweave track for the command that creates the entry, or Track files and directories for choosing what belongs in the repository at all.