Personal Dotfiles

最終更新: 2026-04-20 対象: 開発者 タグ: category/setup, layer/core, environment/cross-platform, audience/developer

High-performance development environment tuned for speed, consistency, and developer experience. Managed with Home Manager for declarative configuration.

Highlights

• Declarative Configuration: Home Manager-based deployment with automatic environment detection (CI/Pi/Default)
• Performance-first dotfiles with local CI parity (mise run ci) before merges
• Documentation centralized in docs/ with navigation at docs/README.md and AI context in .kiro/steering/
• LLM/AI entrypoint available at llms.md, with project rules rooted in AGENTS.md
• Modular stack: Zsh (6-tier), Neovim (Lazy.nvim), WezTerm (tmux-style) with FZF-backed Git widgets
• Versioning via Mise + Homebrew; AI/CLI helpers documented in CLAUDE.md and .claude/

Documentation Map

• Navigation: docs/README.md
• LLM/AI entrypoint: llms.md
• Setup (SST): docs/setup.md
• Performance metrics/history: docs/performance.md
• Maintenance cadence & troubleshooting: docs/tools/workflows.md
• Documentation governance: docs/documentation.md
• AI steering (always loaded): .kiro/steering/
• Tool inventory: TOOLS.md

Getting Started

Prerequisites

• git
• zsh
• curl
• Homebrew (macOS) or your system package manager
• nix (installed via brew bundle in this repo for macOS)
• Optional: home-manager (otherwise use nix run home-manager -- ...)

If you're on a fresh macOS machine, scripts/bootstrap.sh installs Homebrew and validates git, zsh, and curl.

Linux/WSL2 package installs (examples):

# Ubuntu/Debian
sudo apt update && sudo apt install -y git zsh curl

# Fedora
sudo dnf install -y git zsh curl

# Arch
sudo pacman -S --noconfirm git zsh curl

Install Nix on Linux/WSL2 via the official installer, then verify nix is on PATH.

Quick Setup (macOS/Linux/WSL2)

# 1. Clone repository
git clone https://github.com/jey3dayo/dotfiles ~/.config
cd ~/.config

# 2. Bootstrap (installs Homebrew if needed on macOS)
sh ./scripts/bootstrap.sh

# 3. Configure Git identity (required)
cat > ~/.gitconfig_local << EOF
[user]
    name = Your Name
    email = your.email@example.com
EOF

# 4. Install packages
brew bundle  # macOS only

# 5. Apply dotfiles configuration with Home Manager
# If `home-manager` is not on PATH yet, use nix run (recommended for first setup)
nix run home-manager -- switch --flake ~/.config --impure

# Or, if you already have home-manager installed
home-manager switch --flake ~/.config --impure

# 6. Restart shell
exec zsh

# 7. Verify installation
zsh-help
mise doctor

What scripts/bootstrap.sh does

• ✅ Installs Homebrew if not present
• ✅ Detects architecture (Apple Silicon vs Intel)
• ✅ Validates prerequisites (macOS, git, zsh, curl)
• ✅ Sets up brew command in current session

What Changed (Home Manager Migration)

• ✅ Declarative Configuration: Configuration files deployed via Nix/Home Manager
• ✅ Automatic Environment Detection: CI > Raspberry Pi > Default (WSL2/macOS/Linux)
• ✅ No More setup.sh: Replaced by nix run home-manager -- switch --flake . --impure (or home-manager switch --flake . --impure if installed)
• ✅ Reproducible: Nix ensures identical configuration across machines

Manual Setup (Already Have Homebrew)

If Homebrew is already installed, skip bootstrap and follow docs/setup.md directly.

📚 Detailed documentation: See docs/setup.md for troubleshooting and environment notes.

Quality & CI

• Local gate: mise run ci (GitHub Actions equivalent)
• Formatting bundle: mise run format (Markdown/JS/TOML/YAML/Lua/Shell)
• Lint bundle: mise run lint
• Documentation rules: docs/documentation.md

Core Stack

• Zsh + Sheldon: 6-tier priority loading with mise-aware PATH optimization and 50+ Git abbreviations/widgets
• Neovim + Lazy.nvim: AI assistance (Supermaven) with LSP-heavy yet fast startup
• WezTerm: Primary terminal with Lua config and tmux-style workflow; Alacritty as GPU-accelerated alternative
• Git + FZF: Widgets and fuzzy pickers for repo/status/add flows
• Versioning: Mise for language runtimes; Homebrew for system packages

Architecture

dotfiles/
├── flake.nix      # Home Manager entrypoint
├── home.nix       # User configuration
├── nix/           # Home Manager modules
│   ├── dotfiles-module.nix  # Custom module
│   └── env-detect.nix       # Environment detection
├── .claude/       # AI assistance, commands, review criteria
├── .github/       # Workflows
├── .kiro/         # Steering docs (always-loaded AI context)
├── docs/          # Human-facing documentation (SST per topic)
├── scripts/       # Setup scripts
│   └── bootstrap.sh  # Homebrew installer (1-shot)
├── zsh/           # Shell (6-tier loading)
├── nvim/          # Editor (Lua config, 15+ LSP)
├── git/           # Version control (widgets, abbreviations)
├── wezterm/       # Terminal (Lua config, tmux-style)
├── alacritty/     # Alternative terminal (GPU-accelerated)
├── tmux/          # Session management
└── Brewfile       # Package management (Homebrew)

Shortcuts & Commands

# Shell help
zsh-help                   # Interactive help system
zsh-help keybinds          # Key bindings reference
zsh-help aliases           # Aliases reference

# Git workflow (FZF-backed widgets; see docs/tools/fzf-integration.md)
Ctrl+]                     # FZF repository selector
Ctrl+g Ctrl+g              # Git diff widget
Ctrl+g Ctrl+s              # Git status widget
Ctrl+g Ctrl+a              # Git add widget
Ctrl+g Ctrl+b / Ctrl+g s   # Git branch switcher (fzf-git powered)
Ctrl+g Ctrl+w              # Git worktree manager (fzf-git powered)
Ctrl+g Ctrl+z              # fzf-git stash picker
Ctrl+g Ctrl+f              # fzf-git file picker

# WezTerm (Ctrl+x leader key)
Ctrl+x c                   # New tab
Ctrl+x [                   # Vim-style copy mode
Alt+hjkl                   # Pane navigation

# Package management
brew bundle                # Install all packages
mise install               # Setup language versions

Maintenance

• Operational cadence and troubleshooting live in docs/tools/workflows.md
• Weekly: brew update && brew upgrade, sync plugins (Sheldon/Neovim/tmux)
• Monthly: home-manager switch --flake ~/.config --impure, measure shell startup, prune unused plugins
• Rollback: home-manager generations to list, home-manager switch --generation <number> to rollback
• Always before merge: mise run ci

---

Status: Production-ready (2026-02-07) License: MIT — optimized for modern development workflows with focus on speed, consistency, and developer experience.