• 🚀 Simple & Fast - Minimal overhead, instant operations, no bloat
• 🔄 Git Integration - Full version control with sync, push, pull commands
• 🔗 Symlink Management - Automatic symlink creation and tracking
• ☁️ Cross-Machine Sync - Clone and deploy dotfiles to new machines instantly
• 🛡️ Safe Operations - Built-in checks to prevent data loss and recursive symlinks
• 📝 No Config Files - Filesystem-based tracking, no YAML complexity
• ⚡ Written in Go - Single binary, no dependencies, cross-platform compilation

• Go 1.20+ (for building from source)
• Git (for version control features)

git clone https://github.com/Ethics03/Dots.git
cd Dots
chmod +x Install.sh
./Install.sh

The install script will:

• ✅ Check for Go and Git
• ✅ Build the binary
• ✅ Install to /usr/local/bin
• ✅ Verify installation

git clone https://github.com/Ethics03/Dots.git
cd Dots
go build -o dots
sudo mv dots /usr/local/bin

./Install.sh

./Install.sh

# Inside WSL
./Install.sh

git clone https://github.com/Ethics03/Dots.git
cd Dots
go build -o dots.exe
move dots.exe $HOME\bin\  # Add to PATH

# Initialize dots (creates ~/.config/dots and git repo)
dots init

Output:

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║                      Initializing Dots                        ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

Setting up dotfiles directory...
   ✓ Created /home/user/.config/dots

Creating configuration files...
   ✓ .gitignore
   ✓ README.md

Initializing git repository...
   ✓ Repository initialized

Creating initial commit...
   ✓ Committed initial files

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║                     Setup Complete!                           ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

# Add a dotfile to tracking
dots add ~/.bashrc

# Add a directory
dots add ~/.config/nvim

dots status

# Set up remote repository
cd ~/.config/dots
git remote add origin https://github.com/username/dotfiles.git

# Sync your dotfiles
dots sync

# 1. Initialize
dots init

# 2. Add your dotfiles
dots add ~/.bashrc
dots add ~/.zshrc
dots add ~/.config/nvim
dots add ~/.gitconfig

# 3. Check what's tracked
dots status

# 4. Set up remote backup
cd ~/.config/dots
git remote add origin git@github.com:yourusername/dotfiles.git

# 5. Sync to GitHub
dots sync -m "Initial dotfiles commit"

# Clone your dotfiles
dots clone git@github.com:yourusername/dotfiles.git

# Link what you need
dots link bashrc
dots link zshrc
dots link nvim

# Check everything is working
dots status

# Edit a dotfile
dots edit bashrc

# Sync changes to remote
dots sync -m "Add new aliases"

# Remove from tracking (restores original file)
dots remove bashrc

~/.config/dots/
├── .git/              # Git repository
├── .gitignore         # Ignore patterns
├── README.md          # Auto-generated README
├── bashrc             # Your dotfiles
├── zshrc
├── gitconfig
└── nvim/              # Nested configs supported
    ├── init.lua
    └── lua/
        └── plugins/

~/
├── .bashrc -> ~/.config/dots/bashrc
├── .zshrc -> ~/.config/dots/zshrc
├── .gitconfig -> ~/.config/dots/gitconfig
└── .config/
    └── nvim -> ~/.config/dots/nvim

• ✅ Prevents recursive symlinks - Won't add files from within ~/.config/dots
• ✅ Validates symlink targets - Ensures symlinks point to correct locations
• ✅ Backup on remove - Restores original files when removing from tracking
• ✅ Git stash on pull - Automatically stashes uncommitted changes before pulling
• ✅ Path validation - Checks if files exist before operations
• ✅ Permission preservation - Maintains file permissions when copying

Symlinks on Windows require either:

• Developer Mode enabled (Windows 10+), OR
• Running as Administrator

Recommended: Use WSL (Windows Subsystem for Linux) for full compatibility.

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

git clone https://github.com/Ethics03/Dots.git
cd Dots
go build -o dots
./dots --help

# Remove incorrect symlink
dots remove <filename>

# Re-add the dotfile
dots add ~/.<filename>

This project is licensed under the MIT License - see the LICENSE file for details.

• Built with Cobra - CLI framework
• Inspired by GNU Stow, yadm, and chezmoi

• 🐛 Bug Reports: GitHub Issues
• 💡 Feature Requests: GitHub Issues
• 📖 Documentation: GitHub Wiki