# gat

> Simple, fast, versioned large-file storage for git.

- [Installation](https://getgat.dev/installation.md): Install gat on macOS, Linux, or Windows, or build it from source.
- [Quickstart](https://getgat.dev/quickstart.md): Track, upload, and restore your first file in a few minutes.
- [Set up a remote](https://getgat.dev/set-up-a-remote.md): Connect Gat to object storage or a local directory.
- [How Gat works](https://getgat.dev/concepts/how-gat-works.md): Git versions the metadata. Gat stores and restores the large files.
- [Automatic sync](https://getgat.dev/concepts/automatic-sync.md): Keep working files aligned with Git, and choose when sync can fetch.
- [Path selection](https://getgat.dev/concepts/path-selection.md): Choose which files and directories Gat uses, and narrow the selection with glob patterns.
- [History selection](https://getgat.dev/concepts/history-selection.md): Choose which Git snapshots Gat uses, and how far back to look.
- [Config inheritance](https://getgat.dev/concepts/config-inheritance.md): Share configuration with your team and override it locally without copying settings.
- [Use Gat MCP in tools](https://getgat.dev/guides/use-gat-mcp.md): Connect your AI assistant to the gat documentation with MCP.
- [Branching and merging](https://getgat.dev/guides/branching-and-merging.md): Publish large-file changes and resolve conflicts with Git.
- [Consuming Gat assets](https://getgat.dev/guides/consuming-gat-assets.md): Import a versioned snapshot of files owned by another repository.
- [Using multiple remotes](https://getgat.dev/guides/using-multiple-remotes.md): Route paths to different stores, create backups, and move existing objects.
- [Improving performance](https://getgat.dev/guides/improving-performance.md): Reduce ingest, sync, and lock-update costs while keeping the tradeoffs clear.
- [Migrating from Git LFS](https://getgat.dev/guides/migrating-from-git-lfs.md): Move current files to Gat while preserving your existing Git history.
- [Migrating from DVC](https://getgat.dev/guides/migrating-from-dvc.md): Move current data and models to Gat without rewriting old commits.
- [Configuration](https://getgat.dev/references/configuration.md): Settings, defaults, and examples for gat.yaml.
- [Remote providers](https://getgat.dev/references/remote-providers.md): Connect S3, Azure Blob, Google Cloud, Alibaba OSS, or a local directory.
- [Feature lifecycle](https://getgat.dev/references/feature-lifecycle.md): What Stable, Experimental, and Deprecated mean for commands and settings.
- [gat add](https://getgat.dev/commands/add.md): Track files and directories and store them in the local cache.
- [gat config](https://getgat.dev/commands/config.md): View or update configuration settings in `gat.yaml`.
- [gat diff](https://getgat.dev/commands/diff.md): Compare files across revisions or against the working tree.
- [gat fetch](https://getgat.dev/commands/fetch.md): Download objects from remote storage into the local cache.
- [gat gc](https://getgat.dev/commands/gc.md): Remove objects from the local cache or remote storage.
- [gat init](https://getgat.dev/commands/init.md): Initialize Gat with hooks, merge support, and a local cache.
- [gat ls-files](https://getgat.dev/commands/ls-files.md): List files with optional path and glob filters.
- [gat mount](https://getgat.dev/commands/mount.md): Import files from another Git repository by path.
- [gat mv](https://getgat.dev/commands/mv.md): Move or rename files and update `gat.lock`.
- [gat pull](https://getgat.dev/commands/pull.md): Download objects and materialize files in the working tree.
- [gat push](https://getgat.dev/commands/push.md): Upload tracked objects to remote storage.
- [gat remote](https://getgat.dev/commands/remote.md): Configure remote storage including local file remotes.
- [gat rm](https://getgat.dev/commands/rm.md): Stop tracking files or directories, optionally keeping local files.
- [gat route](https://getgat.dev/commands/route.md): Route files to specific storage remotes by path.
- [gat selection](https://getgat.dev/commands/selection.md): Manage named path selections and the default selection.
- [gat status](https://getgat.dev/commands/status.md): Check file status locally or on remote storage.
- [gat sync](https://getgat.dev/commands/sync.md): Reconcile the working tree and materialize files.
- [gat system](https://getgat.dev/commands/system.md): Inspect, repair, or clean internals and local cache state.