Dotweave

Git-backed configuration sync for your development environment.

Documentation · Getting Started · 한국어

Dotweave is a cross-platform CLI that syncs the configuration files in your home directory across multiple devices using git.

Most dotfiles tools start from the repository and ask you to shape your local system around it. Dotweave takes the opposite approach — your real config under HOME is the source of truth, and the git repository is just the sync artifact.

Features

• Track files and directories under your home directory
• Encrypt secrets with age before storing in the repo
• Profiles for syncing different subsets on different machines
• Platform-specific paths across Windows, macOS, Linux, and WSL
• Dry-run previews for both push and pull directions

Quick Start

# Install with npm on macOS, Linux, WSL, or as a cross-platform fallback
npm install -g @tinyrack/dotweave

# Initialize
dotweave init

# Track some configs
dotweave track ~/.gitconfig
dotweave track ~/.zshrc
dotweave track ~/.ssh/config --mode secret

# Push local state to sync repo
dotweave push

On Windows, install dotweave from the Microsoft Store once the listing is live. Portable Windows .exe files remain attached to GitHub Releases for manual use.

Documentation

For detailed guides, command reference, and troubleshooting, visit the Dotweave documentation site.

License

MIT