Production-grade portable one-click dotfiles for Linux and Windows 11 software engineering environment.

Auto-detecting, auto-bootstraping, idempotent, gracefully degrading, full terminal tooling, fully vibecoding-enabled.

Editor & Terminal

• Neovim 0.12+ with built-in package manager, LSP/Treesitter config, and native completion
• WezTerm GPU-accelerated terminal (IosevkaTerm Nerd Font)
• Rose Pine theme across all configs

Development Tools

• 20 LSP servers for complete language intelligence
• 30 Treesitter parsers for advanced syntax highlighting
• 40+ CLI tools for modern development workflows (fzf, yazi, zoxide, bat, eza, lazygit, gh, ripgrep, fd, tokei, btop, repomix, docker-compose, helm, kubectl)

AI-Native Agentic Development

• Full support for Claude Code and OpenCode
• 4 MCP servers: context7, playwright, repomix, serena
• Hookify rules: Per-language quality check reminders (16 languages/formats)
• Auto-detect & trigger format/lint/check: Git pre-commit/commit-msg + Claude Code PostToolUse & Stop hooks
• System instruction sync across all repos (CLAUDE.md, AGENTS.md, GEMINI.md, RULES.md)

Automation & Safety

• Idempotent bootstrap and update-all (safe to run multiple times)
• Auto-detection with graceful degradation
• OneDrive-aware on Windows
• Timestamped backup/restore before major changes

Tested Platforms

• Linux (Ubuntu 26.04+)
• Windows 11 (PowerShell 7+)

Required Clone Location: This repository MUST be cloned to ~/dev/github/dotfiles.

For Docker/Kubernetes setup, see DOCKER_K8S.md.

git clone https://github.com/lavantien/dotfiles.git ~/dev/github/dotfiles
cd ~/dev/github/dotfiles
chmod +x allow.sh && ./allow.sh
./bootstrap.sh
chsh -s $(which zsh)
exec zsh

git clone https://github.com/lavantien/dotfiles.git ~/dev/github/dotfiles
cd ~/dev/github/dotfiles
chmod +x allow.sh && ./allow.sh
./bootstrap.sh
exec zsh

git clone https://github.com/lavantien/dotfiles.git $HOME/dev/github/dotfiles
cd $HOME/dev/github/dotfiles
.\bootstrap.ps1
. $PROFILE

which n  # Should point to nvim
which lg  # Should point to lazygit
up  # Runs update-all

Windows uses .ps1 scripts, Linux/macOS uses .sh scripts.

All scripts use hardcoded defaults by default (categories: full, interactive prompts).

cp .dotfiles.config.yaml.example ~/.dotfiles.config.yaml
vim ~/.dotfiles.config.yaml
./bootstrap.sh  # Auto-detects config

Configuration Priority: Command-line flags > Config file > Hardcoded defaults

./healthcheck.sh

# JSON output (for CI/CD)
./healthcheck.sh --format json

fzf, yazi, zoxide, bat, eza, lazygit, gh, ripgrep, fd, tokei, btop, repomix, docker-compose, helm, kubectl

context7, playwright, repomix, serena

mermaid-cli (mmdc) - Generate Mermaid diagrams from command line

ComfyUI Desktop - AI image generation (requires comfy install after bootstrap)

Pre-commit: auto-format, lint, type-check, re-stage fixed files

Commit-msg: enforce Conventional Commits (feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert)

Platform-specific: .sh for Linux/macOS, .ps1 for Windows

PostToolUse hooks are deprecated - replaced by Hookify rules for quality checks.

Statusline hook is still active and auto-registered in ~/.claude/settings.json.

Hookify provides per-language quality check reminders that trigger automatically when editing files. Rules are stored in .claude/hookify.*.local.md and work immediately after deployment - no restart needed.

Available Rules:

• hookify.quality-go.local.md - Go (gofmt, goimports, golangci-lint, go vet, go test)
• hookify.quality-rust.local.md - Rust (rustfmt, cargo check, clippy, test)
• hookify.quality-python.local.md - Python (ruff, mypy, pytest)
• hookify.quality-typescript.local.md - TS/JS (prettier, eslint, tsc, npm test)
• hookify.quality-csharp.local.md - C# (dotnet format, build, test)
• hookify.quality-php.local.md - PHP (pint, phpstan, psalm, phpunit)
• hookify.quality-shell.local.md - Shell (shfmt, shellcheck)
• hookify.quality-lua.local.md - Lua (stylua, selene)
• hookify.quality-c-cpp.local.md - C/C++ (clang-format, clang-tidy, cppcheck)
• hookify.quality-markdown.local.md - Markdown (prettier, markdownlint)
• hookify.quality-yaml.local.md - YAML (prettier, yamllint)
• hookify.quality-json.local.md - JSON (prettier, jq)
• hookify.quality-svelte.local.md - Svelte (prettier, svelte-check)
• hookify.quality-typst.local.md - Typst (typst check)
• hookify.quality-toml.local.md - TOML (taplo)

Managing Rules:

• Enable/Disable: Set enabled: true/false in the rule frontmatter
• Create new: Add .claude/hookify.{name}.local.md files to your dotfiles
• View active: Use /hookify:list command in Claude Code

~/.config/opencode/opencode.json is merged (not overwritten):

• Adds missing MCP servers
• Updates existing ones
• Preserves any existing settings not managed by dotfiles

npm-installed LSPs (typescript-language-server, pyright-langserver, intelephense) need cmd.exe /c wrapper. Auto-patches marketplace.json to fix spawn EINVAL errors.

On Windows, MCP servers that use npx (like zai-mcp-server) also need the cmd.exe /c wrapper in ~/.claude.json:

"mcpServers": {
  "zai-mcp-server": {
    "command": "cmd.exe",
    "args": ["/c", "npx", "-y", "@z_ai/mcp-server"]
  }
}

This fixes the "Windows requires 'cmd /c' wrapper to execute npx" warning in MCP diagnostics.

ComfyUI Desktop (Windows): After bootstrap via winget, run comfy install to complete setup:

comfy install

This installs required models and dependencies for AI image generation.

Leader key is Space.

See CHANGELOG.md for version history and changes.

MIT