Welcome to dotts

dotts is a beautiful CLI for managing dotfiles across multiple machines and platforms. It provides an interactive TUI wizard, profile-based configuration inheritance, and support for multiple package managers.

Why dotts?

Managing dotfiles across different machines can be painful. You end up with a mess of symlinks, shell scripts, and manual interventions. dotts solves this with:

• Profile Inheritance - Define base configs and extend them for specific machines
• Alternate Files - Use the ## suffix pattern for machine-specific variations
• Interactive Setup - Beautiful TUI wizard guides you through the process
• Package Management - Install packages with nix, brew, pacman, apt, and more

Quick Start

Install dotts with a single command:

curl -fsSL https://dotts.4o4.sh/install.sh | sh

wget -qO- https://dotts.4o4.sh/install.sh | sh

Then initialize your system:

dotts init

The interactive wizard will guide you through:

1. Selecting a config source (starter template, fork, or your own repo)
2. Configuring your machine profile
3. Setting up personal information for templates
4. Choosing which features to enable
5. Installing packages and linking dotfiles

How It Works

dotts separates the tool from your configuration:

Next Steps