Devsync

Devsync is a CLI tool that syncs your development environment config files (dotfiles) with Git. Keep a consistent environment across multiple machines.

---

What Devsync can do

• Track files and directories: Register files and folders as sync targets with track.
• Push / Pull sync: Use push to mirror your local config into the repository, and pull to apply the repository state back to your local machine.
• Secret encryption: Safely store and sync sensitive files like tokens and keys using age encryption.
• Profiles: Assign different profiles per machine to selectively sync a subset of your config.
• Platform-specific paths: Manage the same config under different paths on Windows, macOS, Linux, and WSL.
• Change preview: Use the --dry-run flag or the status command to see what would change before applying anything.
• Health check: Use doctor to validate your repository state, config, and tracked paths all at once.

---

How it differs from other tools

stow and chezmoi are excellent tools — battle-tested and full-featured.

However, both treat the repository as the source of truth, which changes how you edit your config.

With chezmoi, you edit files through chezmoi edit ~/.zshrc rather than directly — editing the local file directly would diverge it from the repository. With stow, your home directory files are replaced with symlinks into the repository, requiring you to reorganize your files to match the repository structure.

Devsync works in the opposite direction. Your local files are always the source of truth. The repository is just a sync artifact. When you want to edit ~/.zshrc, just open it in your editor. When you’re ready to sync, run devsync push.

There are trade-offs: Devsync doesn’t have the powerful template-based file transformation that chezmoi offers. It’s not designed for complex scenarios where config content needs to differ per machine — it keeps your editing workflow natural while syncing config across devices.