dotfiles

Me dotfiles.

Quick start on a new machine

One-liner bootstrap

wget -qO- https://raw.githubusercontent.com/d-gubert/dotfiles/main/bootstrap.sh | bash

This clones the repo to ~/dev/dotfiles, installs git first if needed, and runs make all.

Manual setup

1. Clone this repo

git clone https://github.com/d-gubert/dotfiles.git ~/dev/dotfiles
cd ~/dev/dotfiles

2. Install software

# Install everything
make all

# Or install by category
make essential       # core tools, shell, window manager
make development     # dev runtimes and CLI tools
make utilities       # optional quality-of-life tools

Individual packages can also be installed on their own:

make install-neovim
make install-zsh     # also installs oh-my-zsh and all plugins

2.1 Stow

Stow would error out if directories already exist and are not owned by it, so we actually run stow as the first step in make.

If you add other configuration files to the ubuntu directory, you can get stow to manage them as well by running make stow.

---

Software

Essential

Tool	Description	Installed via
alacritty	GPU-accelerated terminal emulator	apt
homebrew	Package manager	install script
zsh	Shell	apt
oh-my-zsh	Zsh framework	install script
powerlevel10k	Zsh theme	git
zellij	Terminal multiplexer	brew
kanata	Software keyboard remapper	brew
i3	Tiling window manager	apt
fzf	Fuzzy finder	brew
ripgrep	Fast grep replacement (rg)	brew
neovim	Text editor	brew
stow	Dotfiles symlink manager	brew
gh	GitHub CLI	brew
glow	Markdown renderer for the terminal	brew
jq	JSON processor	brew
arandr	GUI front-end for xrandr (display configuration)	apt
bat	cat with syntax highlighting	apt
xclip	Clipboard CLI tool	apt
docker	Container runtime	install script
btop	System resource monitor	apt
ffmpeg	Audio/video processing	apt

Oh-My-Zsh plugins

Plugin	Description
zsh-autosuggestions	Fish-like command suggestions
zsh-syntax-highlighting	Shell syntax highlighting
zsh-vi-mode	Better vi mode for zsh

Development

Tool	Description	Installed via
volta	Node.js toolchain manager	install script
dvm	Deno version manager	install script
meteor	Full-stack JavaScript framework	install script
vi-mongo	MongoDB TUI	brew
lazygit	Terminal UI for git	brew
ast-grep	AST-based code search and rewrite (sg)	brew

Utilities (Optional)

Tool	Description	Installed via
jiratui	Jira TUI client	brew
tealdeer	Fast tldr client	brew
carapace	Multi-shell completion generator	brew
tree-sitter	Parser generator and incremental parsing	brew