https://doc.dotfiles.io https://doc.dotfiles.io/AI/

AI helpers are off by default. You choose if and when to turn them on.

Sebastien Rousseau https://doc.dotfiles.io/ARCHITECTURE/

Core architectural decisions and system design of the dotfiles shell distribution.

Sebastien Rousseau https://doc.dotfiles.io/CONFIG_STRATEGY/

Configuration Management Strategy — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/GOLD-STANDARD-AUDIT/

Scoring of this repository against the eight categories of the repository gold standard, before and after the feat/gold-standard work. Every row carries…

Sebastien Rousseau https://doc.dotfiles.io/GOVERNANCE/

Governance — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/MAINTAINERS/

This project is maintained by a single primary maintainer with an explicit, documented governance model (see GOVERNANCE.md).

Sebastien Rousseau https://doc.dotfiles.io/MINIMUM-TOOLCHAIN/

This project has no compiler and therefore no MSRV. The equivalent contract is the set of interpreter and tool versions the framework runs on, and — more…

Sebastien Rousseau https://doc.dotfiles.io/NAMING_CONVENTIONS/

This document defines the naming conventions for all files in the dotfiles repository.

Sebastien Rousseau https://doc.dotfiles.io/STRUCTURE/

This document maps every top-level path in the repository to its purpose. Skim it once and you should be able to answer:

Sebastien Rousseau https://doc.dotfiles.io/adr/

This directory contains Architecture Decision Records (ADRs) that document significant architectural decisions made in this project.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-001-ci-cd-pipeline/

ADR-001: Multi-stage CI/CD Pipeline Design — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-002-shell-performance/

ADR-002: Shell Performance Optimization Strategy — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-003-security-first/

ADR-003: Security-First Approach — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-004-cli-architecture/

ADR-004: Chezmoi + Custom CLI Wrapper Architecture — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-005-chezmoi-choice/

ADR-005: Chezmoi as Dotfiles Manager — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-006-shell-selection/

ADR-006: Zsh as Default Shell — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-007-multi-shell-parity/

ADR-007: Multi-Shell Parity Strategy — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-008-alias-system-architecture/

ADR-008: Alias System Architecture — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-009-wallpaper-driven-theming/

ADR-009: Wallpaper-Driven Theming Engine — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-010-starship-transient-prompt/

ADR-010: Enable Starship Transient Prompt in Zsh and Fish — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-011-nushell-tier3-keep/

ADR-011: Keep Nushell as Tier-3 Reference with Minimum-Viable Caching — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-012-ai-fleet-local-proxy/

ADR-012: AI Fleet — Native Local Claude Proxy and Cockpit — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-013-single-mutation-authority/

Status: Accepted for the modular architecture; legacy migration remains incomplete.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-014-dpp-v1/

Status: Accepted; hello profile implemented, full DPP conformance remains gated.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-015-transaction-recovery/

Status: Accepted; restricted Unix hello transaction implemented.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-016-plugin-trust-sandbox/

Status: Accepted; audit and experimental Linux process profiles implemented.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-017-sensitive-data-boundary/

Status: Accepted; no secret capability in the hello profile.

Sebastien Rousseau https://doc.dotfiles.io/adr/ADR-018-read-only-mcp-isolation/

Status: Accepted target; isolated MCP service not implemented by hello.

Sebastien Rousseau https://doc.dotfiles.io/architecture/AI_COST_OPTIMIZATION/

This dotfiles framework ships an opinionated AI-cost layer designed to keep token spend predictable and low while still using the smartest model for…

Sebastien Rousseau https://doc.dotfiles.io/architecture/INTEROP/

How dotfiles commands and shims map across macOS, Linux, and WSL2.

Sebastien Rousseau https://doc.dotfiles.io/architecture/THEME_COMPATIBILITY_CONTRACTS/

The first strangler-migration guard is executable compatibility evidence, not a new mutation engine. The legacy theme path remains authoritative at runtime.

Sebastien Rousseau https://doc.dotfiles.io/architecture/WALKTHROUGH/

A hands-on tour of the dotfiles after installation. Run each step in your terminal to get comfortable with what's available.

Sebastien Rousseau https://doc.dotfiles.io/architecture/fleet-deployment/

Fleet Deployment Architecture — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/articles/

Long-form writing on the design and operation of the .dotfiles framework: deep dives into performance, supply-chain safety, developer experience, and the…

Sebastien Rousseau https://doc.dotfiles.io/articles/2026-07-05-custom-mkdocs-material-dark-theme/

Custom Documentation Sites in 2026: Building a Distinctive Dark-Themed Developer Reference on MkDocs Material Without Forking — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/articles/2026-07-05-fish-startup-abbr/

Fish Startup in 2026: Cutting Interactive Shell Latency by Half with abbr on Multi-Shell Dotfiles — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/guides/INSTALL/

Set up on macOS, Linux, or WSL in 3 to 5 minutes.

Sebastien Rousseau https://doc.dotfiles.io/guides/MACOS_ICLOUD_SYMLINKS/

On macOS, this dotfiles setup can (safely) symlink personal directories into iCloud Drive so ~/Desktop, ~/Documents, ~/Downloads, ~/Movies, ~/Music,…

Sebastien Rousseau https://doc.dotfiles.io/guides/NEOVIM_IDE_GUIDE/

Neovim — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/guides/THEMING/

The dotfiles ship a wallpaper-driven theme system that generates terminal color palettes directly from wallpaper images using K-Means clustering in CIELAB…

Sebastien Rousseau https://doc.dotfiles.io/guides/TROUBLESHOOTING/

Quick checks for common issues.

Sebastien Rousseau https://doc.dotfiles.io/guides/WSL2_NIX_TROUBLESHOOTING/

WSL2 & Nix Integration Troubleshooting Guide — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/interop/A2A/

The repository now ships an agent card and an A2A-ready discovery document.

Sebastien Rousseau https://doc.dotfiles.io/interop/POWERSHELL/

This page documents how PowerShell 7.4 LTS / 7.5+ support is exercised in CI and what specifically is verified. Closes the docs slice of #860.

Sebastien Rousseau https://doc.dotfiles.io/migration/from-bare-git-repo/

The git --git-dir=$HOME/.dotfiles --work-tree=$HOME pattern, usually behind a config alias. No dependencies, no symlinks, no templating — and $HOME is the…

Sebastien Rousseau https://doc.dotfiles.io/migration/from-gnu-stow/

Stow builds a symlink farm: ~/.bashrc is a symlink into ~/dotfiles/bash/.bashrc. This framework renders real files into $HOME from a source tree. That…

Sebastien Rousseau https://doc.dotfiles.io/migration/from-plain-chezmoi/

The shortest migration here, because there is no engine change: this framework is chezmoi, plus a source-tree layout, a CLI, and the tooling around them.…

Sebastien Rousseau https://doc.dotfiles.io/operations/ATTESTATION/

Workstation Attestation — .dotfiles documentation.

Sebastien Rousseau https://doc.dotfiles.io/operations/CI_CADENCE/

This page tabulates every GitHub Actions workflow in .github/workflows/ with its trigger cadence and the rationale for that cadence. Maintained under issue…

Sebastien Rousseau https://doc.dotfiles.io/operations/CI_COMPOSITES/

This page documents the repo-local composite actions under .github/actions/. These exist so the most-repeated CI setup blocks have one canonical…

Sebastien Rousseau