---
render_with_liquid: false
---

# .dotfiles

Cross-platform, signed, local-first dotfiles for macOS, Linux, and WSL.

[![Build](https://img.shields.io/github/actions/workflow/status/sebastienrousseau/dotfiles/ci.yml?style=for-the-badge&logo=github)](https://github.com/sebastienrousseau/dotfiles/actions)
[![Version](https://img.shields.io/badge/Version-v0.2.503-blue?style=for-the-badge)](https://github.com/sebastienrousseau/dotfiles/releases/tag/v0.2.503)
[![Downloads](https://img.shields.io/github/downloads/sebastienrousseau/dotfiles/total?style=for-the-badge)](https://github.com/sebastienrousseau/dotfiles/releases)

This site is published from the `docs/` directory on `master` and tracks the current workstation baseline, operational guidance, and security material for the repository.

## Start Here

- [Repository README](https://github.com/sebastienrousseau/dotfiles#readme)
- [Install guide](guides/INSTALL.md)
- [Troubleshooting](guides/TROUBLESHOOTING.md)
- [Support matrix](reference/SUPPORT_MATRIX.md)

## Workstation Operations

- [Utilities and `dot` CLI](reference/UTILS.md)
- [Trusted agent workstation](operations/TRUSTED_AGENT_WORKSTATION.md)
- [Workstation attestation](operations/ATTESTATION.md)
- [Operations runbooks](operations/OPERATIONS.md)
- [Architecture overview](architecture/ARCHITECTURE.md)
- [Repository layout](architecture/REPO_LAYOUT.md)

## Security and Governance

- [Security overview](security/SECURITY.md)
- [Security checklist](security/SECURITY_CHECKLIST.md)
- [Compliance](security/COMPLIANCE.md)
- [Policy bundle releases](security/POLICY_RELEASES.md)
- [Threat model](security/THREAT_MODEL.md)

## Current Release

- Current tagged release: [`v0.2.503`](https://github.com/sebastienrousseau/dotfiles/releases/tag/v0.2.503)
- Latest release feed: [GitHub releases](https://github.com/sebastienrousseau/dotfiles/releases/latest)
- Source repository: [sebastienrousseau/dotfiles](https://github.com/sebastienrousseau/dotfiles)