Introduction

bright-thread is a small command-line tool that keeps your dotfiles in sync across machines. It stores them in a plain Git repository and links them into place, so there is nothing new to learn and nothing to lock you in.

Installation

pipx install bright-thread

Python 3.9 or newer is required. A standalone binary is also published with every release.

Quick start

bright-thread init git@example.com:you/dotfiles.git
bright-thread add ~/.gitconfig ~/.config/nvim
bright-thread sync

Files are linked, never copied. Removing bright-thread leaves your files exactly where they are.

Configuration

Settings live in ~/.config/bright-thread/config.toml. Every option has a sensible default; most people never touch it.