Skip to content

.dotfiles

Cross-platform, signed, local-first dotfiles for macOS, Linux, and WSL — multi-shell parity (bash/zsh/fish/nushell), a fast dot CLI, wallpaper-driven themes, SLSA-signed releases, and AI/MCP-aware tooling.

Install → GitHub Utilities Architecture

What's inside

  • :material-console:{ .lg .middle } Multi-shell parity

    Bash, Zsh, Fish, Nushell — same aliases, functions, prompt, and completions. Cross-shell env parity from .chezmoidata.toml.

    → Shell hub

  • :material-lock-check:{ .lg .middle } Signed & attested

    Every commit SSH-signed, DCO enforced, SLSA-signed releases, SBOM + CVE gate, secret encryption via age.

    → Security

  • :material-palette:{ .lg .middle } 190 wallpaper-driven themes

    K-Means CIELAB color extraction. Terminal, editor, DE — all follow the wallpaper. dot theme rebuild --force regenerates from ~/Pictures/Wallpapers/.

    → Theme system

  • :material-rocket-launch:{ .lg .middle } Fast dot CLI

    142+ subcommands: apply, health, doctor, heal, ai, agent, fleet, secrets, teleport, uninstall — with fzf pickers and a Bubble Tea cockpit.

    → CLI reference

  • :material-check-decagram:{ .lg .middle } CI you can trust

    35+ checks — shellcheck, shfmt, luacheck, stylua, CodeQL, Snyk, grype/SBOM, deps.dev, doc-drift gate, examples contract at 100%.

    → Operations

  • :material-earth:{ .lg .middle } Cross-platform

    macOS (Intel & Apple Silicon), Linux (Ubuntu, Fedora, Arch, Alpine, openSUSE), WSL, PowerShell 7.5+, real BSDs.

    → Support matrix

  • :material-brain:{ .lg .middle } AI & MCP aware

    18-agent fleet cockpit (dot ai), local Claude gateway, MCP registry, context patterns, provider secrets — first-class support, not bolted on.

    → AI operations

  • :material-account-cog:{ .lg .middle } Chezmoi under the hood

    Deterministic templates, feature flags, profiles, run_onchange_ hooks. Everything lives in defaults/ and applies to $HOME on-demand.

    → Architecture

Quick start

Install onto a fresh machine:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/sebastienrousseau/dotfiles/main/install.sh)"

iwr -useb https://raw.githubusercontent.com/sebastienrousseau/dotfiles/main/install.ps1 | iex

Once installed:

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

Where to next

Current release