dotfiles/README.md
Claude 096c3c8afa
feat(install): switch to Homebrew for the CLI toolchain
Ubuntu 24.04's apt versions of fzf/fd/bat/eza/zoxide/ripgrep/tmux/nvim/
lazygit/starship are frozen at April 2024 — and the previous GitHub-
release downloads went stale the moment you stopped re-running the
installer. Homebrew on Linux fixes both: always-latest releases and a
single 'brew upgrade' to update the whole CLI stack.

Two-tier install:
  apt   - zsh + base plumbing + WezTerm (vendor repo) + Brave Beta
          (vendor repo). Vendor repos auto-update via 'apt upgrade'.
  brew  - fzf fd bat eza zoxide ripgrep tmux neovim lazygit starship
          gh zsh-syntax-highlighting zsh-autosuggestions
  nvm   - official installer (pinned NVM_VERSION)
  tpm   - tmux plugin manager clone

New files:
  install/Brewfile - bundle for 'brew bundle'
  install/lib/brew.sh - Homebrew bootstrap + brew bundle
  install/lib/extras.sh - nvm + tpm
  install/install.sh - rewired entry point with --packages-only,
    --dotfiles-only, --help
  install/README.md - new docs for the two-tier strategy

.zshrc:
  - Source brew shellenv first when present, so brew bins win on PATH
  - 'update' alias now: brew upgrade && sudo apt update && sudo apt upgrade
    (previously apt-only; before that pacman-only)

Drops install/lib/packages.sh entries that the now-Brewfile-managed tools
duplicated, and removes the GitHub-release tarball install path.
2026-06-10 16:54:47 +00:00

1.4 KiB

dotfiles

Linux dotfiles oriented around Pop!_OS 24.04 (Cosmic DE). Plain Debian package paths in .zshrc with a fallback for Arch, so they also work on Arch machines if you ever switch back.

Quick Setup

# Clone
git clone <repo-url> ~/dotfiles

# Symlink configs
ln -sfn ~/dotfiles/.config/nvim ~/.config/nvim
ln -sfn ~/dotfiles/.config/tmux ~/.config/tmux
ln -sfn ~/dotfiles/.config/starship ~/.config/starship
ln -sfn ~/dotfiles/.config/lazygit ~/.config/lazygit
ln -sfn ~/dotfiles/.config/wezterm ~/.config/wezterm
ln -sfn ~/dotfiles/.config/zed ~/.config/zed
ln -sfn ~/dotfiles/.config/.ideavimrc ~/.ideavimrc
ln -sfn ~/dotfiles/.zshrc ~/.zshrc
ln -sfn ~/dotfiles/.gitconfig ~/.gitconfig

Install

On Pop!_OS / Ubuntu 24.04, run the bundled installer. It uses apt for the system base + GUI apps (WezTerm, Brave Beta) and Homebrew for the CLI toolchain (fzf, fd, bat, eza, zoxide, ripgrep, tmux, neovim, lazygit, starship, gh, zsh plugins) so those tools stay current — one brew upgrade updates everything.

~/dotfiles/install/install.sh

See install/README.md for flags and the full package list. The update alias runs brew upgrade && sudo apt upgrade.

Theme

Kanagawa theme with two variants: dragon (dark) and wave (darker blue).

Set in shell:

export KANAGAWA_THEME="wave"  # or "dragon"