bjschafer's dotfiles

This repo is how I manage my dotfiles -- config for my shell environment.

While this is for my own use, you're welcome to look at, be inspired by, or straight up steal anything that catches your eye -- at your own risk.

I regularly run macOS, Debian stable, and Arch, so my dotfiles are mostly portable across those systems.

Possibly interesting things

• Shell aliases now live in .config/zsh/aliases.zsh.
• Most other custom profile garbage lives alongside it in .config/zsh.
• Nested tmux on remote host (just hit F12!)
• Interactive shells auto-attach to tmux -- see below for how to turn that off per-machine.
• Local overrides for things like ZSH .zshrc.local and Git .gitconfig.local.
• I try to only load/install things where applicable, to keep things lighter weight.

tmux autostart

.config/zsh/70-tmux.zsh defines tmux_autostart, which .zshrc calls as its very last line. It attaches to an existing session -- preferring an unattached one, so a second terminal doesn't mirror the pane I'm already looking at -- or starts a new session named main (override with ZSH_TMUX_SESSION).

To disable it on a machine, e.g. one running an agentic dev tool that wants the shell to itself, either:

echo 'ZSH_TMUX_AUTOSTART=0' >> ~/.zshrc.local   # fits the .zshrc.local convention
touch ~/.config/zsh/no-tmux-autostart            # order-independent, no config edit

It also skips itself automatically when already inside tmux/screen/zellij, when stdin or stdout isn't a TTY, and inside editor- or agent-driven terminals (VS Code, Emacs, neovim, Claude Code).

Note the invocation has to stay last in .zshrc: the numbered files are sourced before .zshrc.local, so the file only defines the function and .zshrc calls it afterward -- otherwise ZSH_TMUX_AUTOSTART would be read before it's set.

Notes

• I manage the dotfiles via yadm, which is mostly a lightweight Git wrapper.
• I use neovim as my primary editor, and lazy.nvim as the plugin manager therein.
• Colorscheme: Catppuccin Frappe
• Fonts:
  • Terminal: Inconsolata (Nerd Font edition)
  • IDEs: Jetbrains Mono (Nerd Font edition)
• Terminal emulator: Wezterm (my config)
  • Why? It's fast for my needs, allows dynamic cross-platform config via Lua, and properly renders fonts on macOS.