gat.lock, so missing working-tree files and lock-only glob matches remain removable. By
default Gat removes both tracked rows and working files; --cached retains the files while dropping .
To reclaim stored bytes, review gat gc and its history-protection rules.
Recover from a partial failure
Recover from a partial failure
Removals are published to
gat.lock before working files are deleted.
If deletion, empty-directory pruning, materialized ownership cleanup, or Git
exclusion regeneration fails afterward, the error identifies the failed stage
and the paths are already untracked. Cleanup may be incomplete. Repeating the
same gat rm does not resume cleanup for those paths; inspect remaining files
and metadata before further cleanup. If ownership cleanup fails with
--cached, preserve retained files before running gat sync: stale ownership
may cause sync to delete them.Usage
All options
All options
Examples
- Delete file
- Keep file
- Directory
Stop tracking the file and remove its working-tree copy.