Skip to content

Modernize dotfiles: mise, Starship, plain zsh and XDG git config - #1

Merged
conuko merged 2 commits into
mainfrom
modernize-dotfiles
Nov 2, 2026
Merged

conuko merged 2 commits into
mainfrom
modernize-dotfiles

Conversation

@conuko

@conuko conuko commented Nov 2, 2026

Copy link
Copy Markdown
Owner

What changed

Shell

  • Replaced oh-my-zsh and Powerlevel10k (maintenance-only since 2024) with plain zsh, Homebrew's zsh-autosuggestions, zsh-syntax-highlighting and zsh-completions, and a lean single-line Starship prompt.
  • New files recreate what oh-my-zsh used to set: zsh/options.zsh (history, directory options, key bindings) and zsh/completion.zsh (compinit with a daily cached dump).
  • Added fzf (Ctrl-R, Ctrl-T, Alt-C, **<Tab>), zoxide (z), and eza/bat/fd aliases.
  • ~/.zprofile is now managed. The old one loaded nvm a second time in every login shell.
  • dotfiles/bin is off PATH, because it shadowed /bin/link.
  • Startup time for a new login shell: about 4 s → about 150 ms. Tool init scripts are cached in ~/.cache/zsh/init, keyed by binary path and modification time, and Homebrew's environment is set statically.

Runtimes

  • mise replaces nvm, pyenv, rbenv and pipx. Global versions live in mise/config.toml; Poetry now comes from mise's pipx backend, which uses uv.
  • idiomatic_version_file_enable_tools lets mise read .nvmrc, .python-version and .ruby-version (off by default since mise 2025.10), so Node switches on cd and nvm use is no longer needed.
  • mise itself is installed from mise.run rather than Homebrew, following mise's own hint. The binary is 134 MB instead of 223 MB and updates itself with mise self-update.

Git

  • Shared config moved to ~/.config/git/config, and ~/.gitconfig is now an untracked local file. Previously ~/.gitconfig was a symlink into the repo, so every git config --global wrote identity data into tracked files. Local values now also correctly override the shared ones; the old [include] at the top did the opposite.
  • New defaults:
    • diff.algorithm=histogram, merge.conflictStyle=zdiff3, rerere
    • push.autoSetupRemote, fetch.prune/pruneTags
    • rebase.autoSquash/autoStash/updateRefs
    • commit.verbose, core.fsmonitor, help.autocorrect=prompt
    • pull.rebase=true
  • delta replaces diff-so-fancy.
  • Commits and tags are signed with SSH instead of GPG.

Other

  • Ghostty config tracked in ghostty/ and the Ghostty cask added.
  • Brewfile regrouped. Added: git-lfs (the local gitconfig already required it), glab, delta, Starship, the zsh plugins, fzf, zoxide, eza, bat, fd, uv, shellcheck. Removed: the language runtimes, gnupg, diff-so-fancy.
  • bin/link: backups keep their path relative to ~, and a one-time migration moves the old ~/.gitconfig symlink out of the way.
  • bin/bootstrap: puts Homebrew on PATH right after a fresh install (previously the Brewfile install was silently skipped), installs mise, and creates allowed_signers.
  • bin/update: upgrades Homebrew, mise and gh extensions, and lists installed packages that no Brewfile mentions.
  • A few safe macOS defaults: no .DS_Store files on network or USB drives, press-and-hold repeats keys, Finder lists folders first.
  • GitHub Actions lint workflow: ShellCheck, zsh -n, Python syntax check.
  • README rewritten, including a shell shortcuts reference.

Why

The setup worked but was slow and out of date. Shell startup took about 4 s, mostly nvm. The gh copilot extension it loaded on every start was retired in October 2025. A fresh bin/bootstrap couldn't reproduce the shell, because nothing installed oh-my-zsh, p10k or nvm.

For reviewers

  • Behavior change: pull.rebase=true makes git pull rebase instead of creating merge commits. fetch.pruneTags=true removes local tags that no longer exist on the remote.
  • cat is aliased to bat, so flags like cat -v fail. \cat runs the original.
  • compinit -i is used because Homebrew's group-writable share/ would otherwise trigger a prompt; all completions still load.
  • Signing: SSH signing needs the key added on GitHub (gh ssh-key add ~/.ssh/id_ed25519.pub --type signing) and on GitLab before new commits show as Verified. Older GPG-signed commits stay verified on GitHub while the GPG key remains uploaded.
  • Already applied on this Mac: installs, links and the ~/.gitconfig migration. The old tool folders were moved to ~/.dotfiles-backups/, not deleted.

Testing

  • shellcheck on all scripts and zsh -n on all zsh files pass.
  • bin/link changes nothing on a second run.
  • In clean login shells:
    • Every runtime resolves to mise.
    • Node follows each project's .nvmrc, and missing versions install automatically.
    • mise doctor reports no problems.
    • fzf, zoxide and the plugins load.
  • git config --global writes to ~/.gitconfig and leaves the repo clean. Test commits show a good SSH signature.
  • brew bundle check is satisfied, and brew outdated is empty.
  • Not yet checked by hand: key bindings in an interactive Ghostty or iTerm tab.

🤖 Generated with Claude Code

conuko and others added 2 commits November 2, 2026 20:41
- Replace oh-my-zsh, powerlevel10k, nvm, pyenv, rbenv and pipx with plain zsh,
  Homebrew plugins, Starship and mise (reads .nvmrc/.python-version/.ruby-version)
- Cache tool init scripts; shell startup drops from ~4s to ~160ms
- Move shared git config to ~/.config/git so `git config --global` writes to the
  untracked ~/.gitconfig; add current git defaults, delta and SSH signing
- Add fzf, zoxide, eza, bat, fd, git-lfs, uv, shellcheck and the Ghostty config
- Manage ~/.zprofile, keep dotfiles/bin off PATH, back up with relative paths
- Add a lint workflow and rewrite the README

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Install mise with the official installer instead of Homebrew: the binary is
  134 MB instead of 223 MB, slightly faster, and updates via `mise self-update`
- Key the cached init scripts on binary mtime too, so self-updates refresh them
- Document the fzf, zoxide, eza, bat and delta shortcuts in the README

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@conuko
conuko merged commit 068d051 into main Nov 2, 2026
2 checks passed
@conuko
conuko deleted the modernize-dotfiles branch November 2, 2026 20:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant