dotfiles

One-command setup for macOS and Linux.

Install

curl -fsSL https://raw.githubusercontent.com/christopherklint97/dotfiles/main/setup.sh | bash

Or clone and run manually:

git clone https://github.com/christopherklint97/dotfiles.git ~/dotfiles
cd ~/dotfiles && ./setup.sh

What's included

Config	Description
.zshrc	oh-my-zsh with autosuggestions and vi-mode
.config/nvim/	Neovim (kickstart.nvim base, git submodule)
.tmux.conf	vi-mode, mouse, dracula theme, vim-tmux-navigator
.wezterm.lua	Dracula theme, macOS-friendly keybindings
.gitconfig	Aliases, fast-forward pulls, rerere, nvim editor
.config/karabiner/	Remap § to backtick for Unicode Hex Input (macOS only)

Post-install (macOS)

Karabiner-Elements remaps § to backtick for ISO keyboards using the Unicode Hex Input layout. It requires manual setup after install:

1. Open Karabiner-Elements — it will prompt for permissions on first launch
2. Grant Input Monitoring in System Settings > Privacy & Security > Input Monitoring (enable karabiner_grabber and karabiner_observer)
3. Add ABC as an input source in System Settings > Keyboard > Input Sources > Edit (Karabiner switches to it briefly for each keypress — you don't need to use it)
4. In Karabiner, go to Complex Modifications > Add predefined rule and enable "Fix backtick on Unicode Hex Input layout"

Machine-specific config

Create ~/.env.local for environment variables that differ per machine (SDK paths, database users, work email overrides, etc.). It's sourced automatically by .zshrc.

How it works

Symlinks are managed by GNU Stow. The installer:

1. Installs Homebrew (macOS and Linux)
2. Installs core packages (neovim, tmux, fzf, ripgrep, etc.)
3. Installs oh-my-zsh + plugins, nvm, tmux plugin manager
4. Symlinks all dotfiles into $HOME
5. Sets zsh as the default shell