v0.2.526 Apache-2.0 OR MIT

One configuration for every shell

Chezmoi-managed dotfiles for macOS, Linux and WSL, with PowerShell parity. The same aliases, prompt and tools across bash, zsh, fish and nushell, driven by one dot command and installed from releases you can verify.

Install Read the docs

What you get

Everything is chezmoi-managed and switched by feature flags and profiles in one data file.

Four shells, one configuration
Bash, zsh, fish and nushell share the same aliases, functions and prompt. Fish is the default login shell; switch with one setting.
The dot command
More than 100 commands for the whole lifecycle: dot sync, dot doctor, dot health, dot heal, dot rollback, dot secrets and more.
Themes that follow the system
114 palette families, each in light and dark. In auto mode the terminal, editor and prompt follow your operating system's appearance.
Ready for AI coding tools
dot ai tools checks 19 terminal AI coding assistants in one view. Everything AI-related is opt-in, and telemetry is off by default.
Profiles and feature flags
Pick laptop, minimal or server, then turn individual features on or off. The same repository suits a workstation and a headless box.
Secrets kept out of the repository
dot secrets stores them in the macOS Keychain, pass, or an age-encrypted local store, never in plain text in your dotfiles.

Install

Download the installer for the latest release, check it against its SHA-256, then run it. You need git and curl; on Linux without shasum, use sha256sum -c - for the check.

Install v0.2.526

r=https://github.com/sebastienrousseau/dotfiles/releases/download
curl -fsSL -o install.sh "$r/v0.2.526/dotfiles-install-0.2.526.sh"
sum=3e2f04a22459883b344f4a22b43845fcb37689b61edfb971d5a7f9319efd86dc
echo "$sum  install.sh" | shasum -a 256 -c - && bash install.sh
dot doctor    # then check the machine

The installer fetches a checksum-verified chezmoi, clones the release to ~/.dotfiles, applies it and puts dot on your PATH. Homebrew, Scoop, AUR, npm and Nix routes are in the install guide.

Where it runs

From the support matrix.

Operating systems

System	Version	Architecture	Status
macOS	14 (Sonoma) or later	Apple Silicon and Intel	Supported, CI tested on Apple Silicon
Ubuntu	22.04 or later	x86_64 and aarch64	Supported, CI tested on 24.04 x86_64
Debian	12 or later	x86_64	Supported
WSL2	Ubuntu 22.04 or later	x86_64	Supported, with a clipboard bridge
NixOS	23.11 or later	x86_64 and aarch64	Supported, via the Nix flake
Windows	10 or 11	x86_64	PowerShell 7.4 LTS or later, CI tested
Fedora, Arch Linux	41 or later, rolling	x86_64	Community, not CI tested

Shells

Shell	Minimum	Coverage
zsh	5.8	Full
bash	5.0 (3.2 for the dot CLI)	Full
fish (default)	4.0	Core CLI and aliases
nushell	0.98	Core CLI and aliases
PowerShell	7.4 LTS	Core CLI and aliases

Verify what you install

Every release ships the evidence to check it. The release verification guide walks through each step.

Checksums
The installer and every archive have a published SHA-256. The install command above refuses to run a file that does not match.
Provenance and signatures
The dot CLI archives carry SLSA provenance signed by the release workflow, and Sigstore bundles cover the installer and archives. Check provenance with gh attestation verify dot-0.2.526.tar.gz --repo sebastienrousseau/dotfiles.
SBOMs and signed commits
Each release attaches SPDX and CycloneDX software bills of materials. Commits are signed and carry a Developer Certificate of Origin sign-off; CI rejects a change without one.

Questions

Where is the documentation?

At doc.dotfiles.io: guides, the dot command reference, architecture and security, and the manual.

Which shell do I get?

Fish is the default login shell. Set default_shell to zsh, fish or nu; bash is configured either way.

Does it work on Windows?

Through WSL2, and natively in PowerShell 7.4 LTS or later, which has its own dot and aliases. It is also packaged for Scoop.

Where do secrets go?

Outside the repository. dot secrets keeps them in the macOS Keychain, pass, or an age-encrypted local store.

Does it collect data?

No. Telemetry is disabled by default, and this website loads nothing from a third party.

How do I remove it?

dot uninstall removes what it installed, after asking you to confirm.

What licence is it under?

Apache-2.0 or MIT, at your choice.

Install .dotfiles Read the docs

One configuration for every shell

What you get

Four shells, one configuration

The dot command

Themes that follow the system

Ready for AI coding tools

Profiles and feature flags

Secrets kept out of the repository