Safe, team-friendly dotfile synchronization in Rust.

ConfigSync manages your local configuration files as code, with git-backed history, role-aware syncing, encrypted secrets, and safety-focused recovery commands.

• Track config changes with commit history and rollback support.
• Sync shared dotfiles across machines without manually managing symlinks.
• Keep sensitive files encrypted in-repo and decrypted locally only.
• Apply machine roles (for example work, personal) to include/exclude files safely.

• Git-based sync: init, push, pull, history, undo
• Local apply engine: apply to restore links/files from tracked state
• Role-aware file targeting via --role
• Encrypted secrets with age via secrets init and secrets add
• Health diagnostics with doctor
• Optional watch mode with watch

Download the latest binary from the Releases page.

cargo install configsync

git clone https://github.com/kowshik24/configsync.git
cd configsync
cargo install --path .

configsync init --role work

Clone existing shared config repo instead:

configsync init --url https://github.com/<you>/<dotfiles>.git --role personal

configsync add ~/.zshrc
configsync add ~/.npmrc --role work

configsync push
configsync pull
configsync apply

• Secret files are stored encrypted in the repo (.age).
• Private key is stored locally (default path under ~/.local/share/configsync/key.txt).
• Back up your key securely. Without it, encrypted files cannot be decrypted.
• On Unix, restored secret file permissions are tightened (600).

• If no origin remote exists, push/pull keep local behavior and print guidance.
• apply skips paths that are already correctly linked.
• undo intentionally blocks reverting the initial repository commit to avoid teardown of baseline setup files.

Run:

configsync init

Configure remote:

git -C ~/.config/configsync remote add origin <your-repo-url>

• Ensure key file exists on current machine.
• Re-run configsync secrets init only for new local key generation.
• Restore the original key backup if you need to decrypt older encrypted files.

configsync doctor

• First-install reliability improvements (init initial commit, safer history/undo behavior)
• Added explicit apply command
• Better commit signature handling when git identity is missing

• Added Rust CLI integration tests for critical flows
• Improved apply UX (Already linked. Skipping. for correct existing symlinks)
• Improved sync warnings and branch fallback handling in pull flows

Contributions are welcome. Please open an issue or submit a pull request.

MIT. See LICENSE.