dotstate

dotstate [command] [options] [arguments]

dotstate is a modern dotfile manager that uses Git for version control while providing a simplified interface for common dotfile operations. It helps users manage configuration files across multiple machines by tracking them in a Git repository.
The tool provides commands for initializing a dotfiles repo, adding files to tracking, synchronizing configurations between systems, and handling platform-specific files. It maintains a clean separation between the actual dotfiles in the home directory and the repository.

-c, --config FILE

Configuration file path

Dotfiles repository directory

Enable verbose output

Show what would be done without making changes

Display help and exit

Display version and exit

init [DIRECTORY]

Initialize a new dotstate repository

Add a file to dotstate tracking

Remove a file from tracking

Synchronize dotfiles to current system

Show repository status

Commit changes to repository

Push changes to remote

Pull changes from remote

List all tracked files

Requires Git to be installed and configured. May overwrite existing files during sync - backups recommended. Platform-specific configurations need manual handling. Symbolic link handling varies by operating system.

dotstate was created as a modern alternative to traditional dotfile managers, focusing on simplicity and Git integration. It aims to provide the power of version control without the complexity of manual Git operations.

git(1), stow(1), chezmoi(1), yadm(1)