https://github.com/sebastienrousseau/dotfiles
The Trusted Shell Platform 🛡️. Universal dotfiles managed by Chezmoi. Features Bash & Zsh for macOS, Linux & WSL. Rust modern tooling & enterprise-grade security.
https://github.com/sebastienrousseau/dotfiles
automation bootstrap chezmoi cli dev-environment dotfiles neovim security tmux zsh
Last synced: 3 months ago
JSON representation
The Trusted Shell Platform 🛡️. Universal dotfiles managed by Chezmoi. Features Bash & Zsh for macOS, Linux & WSL. Rust modern tooling & enterprise-grade security.
- Host: GitHub
- URL: https://github.com/sebastienrousseau/dotfiles
- Owner: sebastienrousseau
- License: other
- Created: 2015-02-16T14:15:57.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2026-02-23T23:35:50.000Z (3 months ago)
- Last Synced: 2026-02-24T06:01:50.457Z (3 months ago)
- Topics: automation, bootstrap, chezmoi, cli, dev-environment, dotfiles, neovim, security, tmux, zsh
- Language: Shell
- Homepage: https://dotfiles.io/
- Size: 4.35 MB
- Stars: 61
- Watchers: 3
- Forks: 17
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE-OF-CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
- Roadmap: docs/ROADMAP.md
Awesome Lists containing this project
README
.dotfiles
The Ultimate, 2026-Ready Shell Distribution for Power Users
---
## ✨ Overview
Dotfiles is a **high-performance, idempotent shell distribution** designed for developers who demand speed, security, and reproducibility. Managed by [Chezmoi](https://github.com/twpayne/chezmoi), it provides a sublime terminal experience across **macOS, Linux, and WSL2**.
It's not just a collection of configs—it's a **curated infrastructure** that evolves with you.
---
## 🚀 The 2026 Next-Gen Frontier
While others are still configuring Bash, we are building the future. This repository includes:
* 🏎️ **Zero-Cost Shell Startup**: Autoloading Fish functions and Zsh lazy-loading for sub-5ms boot times.
* ❄️ **Nix Flakes Integration**: Bit-for-bit identical environments for ultimate portability.
* 📊 **Nushell (Data-Driven)**: Process system data as structured tables, not just strings.
* 🧠 **Local AI RAG**: A local semantic search (`dot-ai`) that knows your dotfiles better than you do.
* ⚙️ **Pueue (Async Daemon)**: Offload heavy tasks (upgrades, builds) to a background queue.
* 💎 **WebAssembly (Wasm)**: Run ultra-fast, pre-compiled tools via `wasmtime`.
---
## 📦 Features at a Glance
| Category | Highlights |
| :--- | :--- |
| **Shells** | **Zsh** (Daily), **Fish** (Performance), **Nushell** (Data) |
| **Editors** | **Neovim** (Lua-powered), **Vim** (Legacy-compatible) |
| **UX** | **Starship** (Prompt), **Zoxide** (Jump), **Atuin** (History), **fzf** (Fuzzy) |
| **Discovery** | **Yazi** (Files), **fd** (Find), **Ripgrep** (Search) |
| **Tools** | **Mise** (Runtimes), **Pueue** (Async), **Delta** (Diffs), **Lazygit** (Git TUI) |
| **Security** | **Age** (Enc), **Sops** (Secrets), **Firewall** (Hardening), **Key Rotation** |
---
## ⚡ Quick Start
> [!IMPORTANT]
> The installer automatically backs up any existing dotfiles to `~/.dotfiles.bak./`.
### 1. The Instant Install
Works on macOS, Linux, and WSL2:
```bash
sh -c "$(curl -fsSL https://dotfiles.io/install.sh)"
```
### 2. Enter the Ecosystem
Once installed, use the `dot` CLI to manage your world:
```bash
dot update # Sync everything (Git + Chezmoi + Nix + Plugins)
dot tools # Explore the curated tool catalog
dot-ai "How do I..." # Ask your local AI about your configuration
```
---
## 🛠️ Portability: Nix & Direnv
For the ultimate "reproducible" experience, we use **Nix Flakes**. Typing `cd ~/.dotfiles` instantly injects a perfect, pre-compiled toolchain into your shell.
```bash
# Enter the deterministic shell
nix develop
```
---
## 🏁 Performance Modes
| Mode | Environment Variable | Best For |
| :--- | :--- | :--- |
| **Standard** | (Default) | Full-featured daily driver. |
| **Fast** | `DOTFILES_FAST=1` | High-speed setup with essential tools. |
| **Ultra** | `DOTFILES_ULTRA_FAST=1` | Minimalist startup (< 1ms) for high-frequency work. |
---
## 📚 Documentation Deep-Dives
- [📂 Tools Catalog](docs/TOOLS.md) — Comprehensive list of all integrated packages.
- [🏛️ Architecture](docs/ARCHITECTURE.md) — How the shell startup, caching, and templates work.
- [🔐 Security & Secrets](docs/SECRETS.md) — Hardening, encryption, and Age/Sops setup.
- [🧠 AI Integrations](docs/AI.md) — Setting up Claude, Gemini, and Aider.
- [⚙️ Operations](docs/OPERATIONS.md) — Daily workflows and maintenance.
- [🆘 Troubleshooting](docs/TROUBLESHOOTING.md) — Common fixes and platform notes.
---
## 🤝 Contributing
Contributions are welcome! Please read our [Contributing Guide](.github/CONTRIBUTING.md) and [Code of Conduct](.github/CODE_OF_CONDUCT.md).
---
## 📜 License
Licensed under the **MIT License**. See [LICENSE](LICENSE) for details.