Snapfig backs up and restores your dotfiles straight from their original locations.
- Getting Started - Installation and your first backup
- CLI Reference - All commands and flags
- Background Runner - Automated backups with the daemon
- Workflows - Common use cases and recipes
- Architecture - How Snapfig works internally
Snapfig copies your configuration files to a local vault (~/.snapfig/vault/) that's automatically versioned with git. Unlike symlink-based tools, you keep working with files in their original locations. Snapfig mirrors them on demand or automatically via the background runner.
- Real copies, not symlinks - Actual redundancy, not just pointers
- Git versioning - Every backup is a commit, full history preserved
- Background sync - Set intervals for copy/push/pull operations
- Smart copy - Only changed files are copied
- Selective restore - Choose exactly which files to restore
- Nested git handling - Preserves or removes
.gitdirs in config repos
snapfig --help
snapfig <command> --helpNext: Getting Started
All docs: Getting Started · CLI Reference · Background Runner · Workflows · Architecture