dotfiles-linux

Personal dotfiles and bootstrap scripts for Debian 12 (bookworm) development VMs.

What's Included

Stow Packages (user config)

Package	What it manages
zsh	.zshrc, .zshenv, .zsh_plugins.txt
git	.gitconfig (aliases, settings)
starship	Starship prompt config
nvim	Full Neovim config (lazy.nvim, 25+ plugins)
lazygit	Lazygit config
gh	GitHub CLI preferences
opencode	OpenCode + oh-my-openagent config

Bootstrap Scripts (system setup)

Script	What it installs
debian12.sh	APT repos (Docker, NodeSource), base packages, zsh
runtimes.sh	Go, Rust, Bun, asdf
cli-tools.sh	nvim, starship, rg, fd, fzf, eza, lazygit, etc.
verify.sh	Post-install sanity checks

Language Runtimes

• Go (via /usr/local/go)
• Rust (via rustup)
• Node.js 22.x (via NodeSource APT)
• Bun
• Elixir + Erlang/OTP (via APT)
• Java OpenJDK 17 (via APT)

CLI Tools

nvim, starship, ripgrep, fd, fzf, eza, lazygit, lazydocker, golangci-lint, zoxide, tree-sitter, gh, bat, flyctl, temporal, antidote

Quick Start (fresh Debian 12 VM)

# Clone the repo
git clone https://github.com/YOUR_USER/dotfiles-linux.git ~/code/dotfiles-linux
cd ~/code/dotfiles-linux

# Run the full bootstrap
bash install.sh

# Restart shell
exec zsh

Post-Install Steps

1. Git identity — copy and edit the template:

   cp templates/gitconfig.user.example ~/.gitconfig.user
   # Edit with your name and email

2. GitHub auth — gh auth login
3. Neovim plugins — open nvim and let lazy.nvim install plugins
4. Docker — log out/in or newgrp docker to apply group

Stow Only (existing setup)

cd ~/code/dotfiles-linux
bash stow.sh

To stow a single package:

stow -Rv -t "$HOME" nvim

To unstow:

stow -Dv -t "$HOME" nvim

Updating Tool Versions

Edit versions/tool-versions.env and re-run the relevant bootstrap script.

What's NOT Included

• SSH keys (~/.ssh/)
• GitHub tokens (~/.config/gh/hosts.yml)
• Git user identity (~/.gitconfig.user)
• Amp/OpenCode auth tokens
• Any cache or generated files