Zero-dependency, single-file dotfile manager.

What Problem Does This Solve?

New machine — how do you quickly restore all your config files (.bashrc, .gitconfig, etc.)?

Copy them manually? Easy to miss something. Use existing tools? Complex dependencies, tedious setup.

The Solution

xdotter’s answer: one config folder + symlinks.

  • Zero dependencies — single .pyz file, download and run
  • Declarative config — TOML file defines the mapping
  • One-command deploy — xd deploy creates all symlinks

Compared to dotter:

  • Simpler — symlinks only, no copy/other deployment modes
  • Zero deps — no Rust compilation needed, Python comes pre-installed
  • Intuitive config — single TOML file, no complex templating

Quick Start

# Download
gh release download --repo cncsmonster/xdotter --pattern xd.pyz --output ~/.local/bin/xd

# Create config and deploy
xd new && xd deploy

Stars, issues, and PRs welcome! ⭐