.dotfiles

Open source Apache-2.0 OR MIT

.dotfiles

Cross-platform, signed, local-first dotfiles for macOS (Apple Silicon and Intel), the major Linux distributions, WSL and PowerShell 7.4 LTS or later. One configuration across bash, zsh, fish and nushell, driven by a fast dot CLI.

Install Read the manual

Quick start

Download and verify the release installer as the install guide shows, then let dot check the machine.

After installing

dot doctor      # verify state
dot health      # dashboard with actionable warnings
dot theme       # pick a wallpaper-driven theme
dot ai          # the AI cockpit
dot help all    # full CLI reference

What's inside

Everything is chezmoi-managed and feature-flagged, and CI runs it on Linux, macOS and Windows.

  • Multi-shell parity

    Bash, zsh, fish and nushell share the same aliases, functions, prompt and completions, driven from one data file.

  • Signed and attested

    Every commit SSH-signed with DCO sign-off, signed releases with an SBOM, and secrets encrypted with age.

  • Wallpaper-driven themes

    Colours extracted from your wallpaper theme the terminal, the editor and the desktop, in light and dark.

  • AI and MCP aware

    A local gateway for your coding agents, an MCP registry and provider secrets, all opt-in and keyless by default.

Why trust it

The behaviour is pinned by tests that run the code, not by text searches.

Mutation-tested
Every pull request plants small bugs in the lines it changes; at least 80% must be caught.
Tested on three systems
Ubuntu, macOS on Apple Silicon and Windows PowerShell run in CI for changes to code and configuration.
Reversible
dot rollback restores the previous state, and nothing is applied from a dirty checkout.

Install .dotfiles