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

Installation

Windows

winget install tinyrack.dotweave

macOS / Linux

brew install tinyrack-net/tap/dotweave

npm

Use npm on any platform, or as a cross-platform fallback.

npm install -g @tinyrack/dotweave

Quick Start

# 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

Documentation

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

License

MIT