Skip to content

tidydots

A cross-platform dotfile management tool

Keep your configuration files organized, versioned, and portable across machines. tidydots manages symlinks, renders templates, installs packages, and clones git repositories --- all from a single YAML file in your dotfiles repo.

  • Symlink-based config management

    Configs are symlinked from your dotfiles repo. Edits sync instantly --- no copying, no drift.

  • Cross-platform

    First-class support for Linux and Windows with OS-specific target paths in every config entry.

  • Template rendering

    Go templates with sprout functions let you generate machine-specific configs from a single source file.

  • Multi-package-manager support

    Install packages through pacman, yay, paru, apt, dnf, brew, winget, scoop, choco, or custom installers.

  • Interactive TUI

    A Bubble Tea terminal interface for browsing, selecting, and managing your applications visually.

  • Git repository management

    Clone and update git repositories as packages --- great for plugin managers, themes, and tools.

  • Smart adopt workflow

    Migrates existing configs into your dotfiles repo automatically, then replaces them with symlinks.

  • Dry-run mode

    Preview every operation before it touches your filesystem with the -n flag.

Install

go install github.com/AntoineGS/tidydots/cmd/tidydots@latest

Get started

Ready to organize your dotfiles?

Get started