Skip to main content
Track files, directories, or quoted glob patterns. Gat caches the bytes, records paths and content IDs in gat.lock, and updates .git/info/exclude. See the file lifecycle for how this becomes a shared Git version. Ignore rules from .gatignore and Git apply during expansion. --force bypasses ignore filtering only for the requested paths. It still rejects Git-tracked files, mount-owned paths, unsupported file types, and Gat or Git infrastructure paths.
If ownership recording or Git exclusion updates fail after publication, the paths are already tracked in gat.lock. The error names the incomplete stage; it does not mean the addition was undone. Inspect the lock and Git exclusions before staging files with Git.

Usage

Examples

Add one large file to gat.lock and the local cache.