https://github.com/lavantien/dotfiles

Universal SWE Dotfiles (Neovim/Wezterm/zsh/pwsh, ClaudeCode/Git Hooks, Linux/Windows) - Battery Included
https://github.com/lavantien/dotfiles

ai automation claudecode config deployment dotfiles dotfiles-automation dx git hooks ide linux llm neovim opencode pwsh windows zsh

Last synced: 11 days ago
JSON representation

Universal SWE Dotfiles (Neovim/Wezterm/zsh/pwsh, ClaudeCode/Git Hooks, Linux/Windows) - Battery Included

Host: GitHub
URL: https://github.com/lavantien/dotfiles
Owner: lavantien
License: apache-2.0
Created: 2023-06-02T20:56:02.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2026-02-07T01:14:15.000Z (17 days ago)
Last Synced: 2026-02-07T13:00:17.126Z (16 days ago)
Topics: ai, automation, claudecode, config, deployment, dotfiles, dotfiles-automation, dx, git, hooks, ide, linux, llm, neovim, opencode, pwsh, windows, zsh
Language: Shell
Homepage:
Size: 47.1 MB
Stars: 33
Watchers: 1
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md

Awesome Lists containing this project

README

          # Universal Dotfiles

[![Security](https://img.shields.io/badge/security-reviewed-brightgreen)](#security) [![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black)](https://github.com/lavantien/dotfiles) [![Windows](https://img.shields.io/badge/Windows-0078D6?logo=windows&logoColor=white)](https://github.com/lavantien/dotfiles) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

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.

---

## Core Features

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, sqlite, 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

- Auto-detect & trigger format/lint/check: Git pre-commit/commit-msg hooks

- Statusline hook for Claude Code (auto-registered in settings.json)

- 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+)

---

## Quick Start

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

>

> **For Docker/Kubernetes setup**, see [DOCKER_K8S.md](DOCKER_K8S.md).

### Linux

```bash

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

```

### macOS

```bash

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

```

### Windows (PowerShell 7+)

```powershell

git clone https://github.com/lavantien/dotfiles.git $HOME/dev/github/dotfiles

cd $HOME/dev/github/dotfiles

.\bootstrap.ps1

. $PROFILE

```

### Verify Installation

```bash

which n  # Should point to nvim

which lg  # Should point to lazygit

up  # Runs update-all

```

---

## Available Commands

| Script | Purpose |

|--------|---------|

| **bootstrap** | Initial setup - installs package managers, SDKs, LSPs, tools, deploys configs |

| **deploy** | Deploy configuration files (Neovim, git hooks, shell, Claude Code) |

| **update-all (up)** | Update all package managers and system packages (20+ managers) |

| **git-update-repos** | Clone/update ALL GitHub repos via gh CLI, optionally sync system instructions |

| **sync-system-instructions** | Sync AI system instructions (CLAUDE.md, AGENTS.md, etc.) to all repos |

| **healthcheck** | Check system health - verify tools, configs, git hooks |

| **backup** | Create timestamped backup before major changes |

| **restore** | Restore from a previous backup |

| **uninstall** | Remove deployed configs (keeps installed packages) |

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

### Bootstrap Options

| Option | Bash | PowerShell | Default |

|--------|------|------------|---------|

| Non-interactive | `-y`, `--yes` | `-Y` | Prompt for confirmation |

| Dry-run | `--dry-run` | `-DryRun` | Install everything |

| Categories | `--categories sdk` | `-Categories sdk` | full |

| Verbose | `--verbose` | `-VerboseMode` | Show detailed output |

### Update-All Options

| Option | Bash | PowerShell | Purpose |

|--------|------|------------|---------|

| Skip pip updates | `--skip-pip` | `-SkipPip` | Skip pip package updates (speeds up update) |

### Installation Categories

| Category | Description |

|----------|-------------|

| minimal | Package managers + git + CLI tools only |

| sdk | Minimal + programming language SDKs |

| full | SDK + all LSPs + linters/formatters (default) |

### Configuration (Optional)

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

```bash

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

| Setting | Values | Default |

|---------|--------|---------|

| categories | minimal, sdk, full | full |

| editor | nvim, vim, code, nano | (none) |

| theme | rose-pine, rose-pine-dawn, rose-pine-moon | (none) |

| github_username | your github username | lavantien |

| base_dir | path to git repos | ~/dev/github |

| auto_commit_repos | true, false | false |

### Health & Troubleshooting

```bash

./healthcheck.sh

# JSON output (for CI/CD)

./healthcheck.sh --format json

```

| Issue | Solution |

|-------|----------|

| Git hooks not running | `git config --global core.hooksPath ~/.config/git/hooks` |

| PowerShell execution policy | `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser` |

| Neovim plugins not installing | In Neovim run `:PackUpdate` |

| zoxide not jumping | Use directories normally for a few days to let zoxide learn |

---

## Complete Tools/Packages Matrix

| Language | LSP | Tester | Formatter | Linter | Type Check |

|----------|-----|--------|-----------|--------|------------|

| Bash | bashls | bats | shfmt | shellcheck | - |

| PowerShell | powershell_es | Pester | Invoke-Formatter | PSScriptAnalyzer | PSScriptAnalyzer |

| Go | gopls | go test | gofmt, goimports | golangci-lint | go vet |

| Rust | rust-analyzer | cargo test | rustfmt | clippy | cargo check |

| Python | pyright | pytest | ruff, black | ruff | mypy |

| JavaScript/TypeScript | ts_ls | jest | prettier | eslint | tsc |

| HTML | html | - | prettier | - | - |

| CSS/SCSS/SASS | cssls | - | prettier | stylelint | - |

| Svelte | svelte | - | prettier | - | svelte-check |

| C/C++ | clangd | Catch2 | clang-format | clang-tidy, cppcheck | compiler |

| C# | csharp_ls | dotnet test | dotnet format | Roslyn analyzers | dotnet build |

| Java | jdtls (Linux/macOS only) | JUnit | checkstyle | checkstyle | javac |

| PHP | intelephense | php, PHPUnit | pint | PHPStan, Psalm | - |

| Scala | metals | ScalaTest | scalafmt | scalafix | scalac |

| Lua | lua_ls | busted | stylua | selene | - |

| Typst | tinymist | built-in | tinymist | tinymist | - |

| Dockerfile | docker_ls | - | - | hadolint | - |

| Docker Compose | docker_ls | - | prettier | - | - |

| Helm | helm_ls | - | prettier | - | - |

| Kubernetes YAML | yamlls | kubectl | prettier | yamllint | - |

| YAML | yamlls | - | prettier | yamllint | - |

| TOML | tombi | - | taplo | - | - |

### CLI Tools

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

### MCP Servers (Claude Code & OpenCode)

context7, playwright, repomix, serena

### Diagram Generation

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

### AI Applications (Windows)

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

---

## Hooks & Config Merging

### Git Hooks

**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

### Claude Code Hooks

**Statusline** hook is auto-registered in `~/.claude/settings.json` for custom command output display.

Quality checks can be configured per-project using project-specific hooks or MCP servers.

### OpenCode Config Merging

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

- Adds missing MCP servers

- Updates existing ones

- Preserves any existing settings not managed by dotfiles

### Claude Code Windows LSP Patching

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

### MCP Server Manual Patching (Windows)

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

```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.

### GUI Applications Post-Installation

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

```powershell

comfy install

```

This installs required models and dependencies for AI image generation.

---

## Neovim Keybindings

Leader key is Space.

| Keybinding | Action |

|------------|--------|

| `-` | Oil (file browser) |

| `q` | Quit |

| `x` | Write and source |

| `'` | Alternate file |

| `pt` | Toggle Typst preview |

| `ps` | Start live preview |

| `pc` | Close live preview |

| `;` | Pick live preview |

| `b` | LSP format |

| `u` | Pack update |

| `e` | FzfLua global |

| `n` | FzfLua combine |

| `/` | Grep current buffer |

| `z` | Live grep native |

| `f` | Files |

| `h` | Help tags |

| `k` | Keymaps |

| `l` | Loclist |

| `m` | Marks |

| `t` | Quickfix |

| `gf` | Git files |

| `gs` | Git status |

| `gd` | Git diff |

| `gh` | Git hunks |

| `gc` | Git commits |

| `gl` | Git blame |

| `gb` | Git branches |

| `gt` | Git tags |

| `gk` | Git stash |

| `\` | LSP finder |

| `dd` | LSP document diagnostics |

| `dw` | LSP workspace diagnostics |

| `,` | LSP incoming calls |

| `.` | LSP outgoing calls |

| `a` | LSP code actions |

| `s` | LSP document symbols |

| `w` | LSP workspace symbols |

| `r` | LSP references |

| `i` | LSP implementations |

| `o` | LSP type definitions |

| `j` | LSP definitions |

| `v` | LSP declarations |

---

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for version history and changes.

---

## License

MIT

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/lavantien/dotfiles

Awesome Lists containing this project

README