Personal terminal and editor configuration — tmux + Neovim (AstroNvim) — plus macOS audio routing.

Theme: Custom colorscheme across tmux, Neovim, and Alacritty.

Dependencies are split into three tiers:

• Required — the setup will not work without these
• Auto-installed — installed automatically by Mason on first Neovim launch
• Recommended — needed for specific formatters/features; noted per-language

These two formatters are expected on your system PATH. Mason cannot install them in environments with private npm registries (corporate proxies, etc.), so they are managed separately:

npm users: If npm install -g fails with an authentication error (corporate registry), use brew install prettier sql-formatter instead.

Mason will download and install these automatically. You do not need to install them manually — but their language runtimes must be present:

Python 3.8+

# macOS / Linux
brew install python

# Ubuntu/Debian
sudo apt install python3 python3-pip

# Windows
scoop install python  OR  winget install Python.Python.3

Java JDK 11+ (required for google-java-format)

# macOS / Linux
brew install openjdk

# Ubuntu/Debian
sudo apt install default-jdk

# Windows
scoop install openjdk  OR  winget install Microsoft.OpenJDK.21

LLVM/clang (required for clang-format)

# macOS (clang is already included with Xcode Command Line Tools)
xcode-select --install

# Linux
brew install llvm  OR  sudo apt install clang-format

# Windows
scoop install llvm  OR  winget install LLVM.LLVM

Node.js 18+ (required for tree-sitter-cli; also needed for npm install -g prettier)

# macOS / Linux
brew install node

# Ubuntu/Debian
sudo apt install nodejs npm

# Windows
scoop install nodejs  OR  winget install OpenJS.NodeJS

The installer handles everything — it installs all dependencies (via Homebrew on macOS/Linux, Scoop on Windows) and then links the configs.

git clone https://github.com/Brandon-Schur/dotfiles.git ~/dotfiles
bash ~/dotfiles/install.sh

install.sh will:

1. Install Homebrew (if missing)
2. Install core tools: git, tmux, neovim, lazygit
3. Install formatters: prettier, sql-formatter
4. Install language runtimes: python, node, openjdk, llvm/clang
5. Install the JetBrainsMono Nerd Font
6. Link the tmux + Neovim + lazygit configs
7. Install tmux plugins (TPM)

Flags:

bash ~/dotfiles/install.sh --no-deps     # link configs only, skip dependency install
bash ~/dotfiles/install.sh --nvim-only   # deps + Neovim config only
bash ~/dotfiles/install.sh --tmux-only   # deps + tmux config only

After install, set JetBrainsMono Nerd Font as your terminal font.

tmux is not available on native Windows; use WSL (below) if you want tmux. For Neovim only:

# 1. Clone the repo (install Git first if needed: https://git-scm.com/download/win)
git clone https://github.com/Brandon-Schur/dotfiles.git $HOME\dotfiles
cd $HOME\dotfiles

# 2. Install ALL dependencies (installs Scoop, git, neovim, lazygit,
#    node, prettier, sql-formatter, python, openjdk, llvm, and the Nerd Font).
#    If you hit an execution-policy error, run the Set-ExecutionPolicy line first.
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
.\scripts\install-deps-windows.ps1

# 3. Open a NEW terminal (so PATH updates apply), then link the Neovim config:
bash scripts\install-nvim.sh

Then set JetBrainsMono Nerd Font in Windows Terminal settings.

# In PowerShell as Administrator:
wsl --install
# Reboot if prompted, open Ubuntu, then run the macOS/Linux one-liner above.

Not part of install.sh, because it needs Loopback, BlackHole, and a one-time manual permission step. Follow audio-priority/README.md → "Set up on a new Mac":

brew install blackhole-2ch
bash ~/dotfiles/audio-priority/install.sh

tmux                         # start a new session
# Press  Ctrl-a  then  Shift-I  to install TPM plugins (first time only)
# Press  Ctrl-a  then  r        to reload config

nvim                         # lazy.nvim auto-installs all plugins on first open
# Mason installs LSP servers and formatters in the background (~1 min)
# Check formatter status:  :ConformInfo
# Check LSP status:        :LspInfo
# Check Mason packages:    :Mason

An fzf picker over sesh list, rendered as an aligned table. Rows are ordered by last use, most recent first, and carry two dates so a session you have returned to for weeks is distinguishable from one you opened this morning.

Digits jump only while the filter is empty; once you type, they filter normally, so directory names containing numbers still work. No modifier-only chords, so nothing fights a tiling window manager.

Install: bash scripts/install-sesh.sh (also run by install.sh). Needs sesh and fzf; zoxide is optional and only fills the uses column. The fast path uses gawk's strftime().

sesh/ holds both a Python reference and an awk fast path:

awk starts in ~2ms against Python's ~21ms, which is most of the difference on a picker you hit constantly. The cost is a duplicated row layout, so run check-picker-parity after touching either — it exists because a real divergence shipped once: the fast path dropped the tmux session path, which silently blanked the uses column for every tmux session, and a naive equality check missed it because no session's directory happened to be in the zoxide database at the time.

Everything below is an intentional customization on top of stock AstroNvim. All files live under nvim/lua/plugins/.

Also in init.lua: <C-Tab>/<C-S-Tab> buffer navigation and a vscode-neovim guard.

lazygit config (lazygit/config.yml): editPreset: nvim-remote — opens files from lazygit in the parent Neovim instead of a nested editor.

Edit nvim/lua/plugins/colorscheme.lua:

opts = {
  colorscheme = "tokyonight-storm",  -- change this line
}

Available: tokyonight-storm, tokyonight-night, tokyonight-moon, tokyonight-day, catppuccin-macchiato, catppuccin-mocha, catppuccin-frappe, catppuccin-latte, astrodark.

1. Find the Mason package name at :Mason or https://mason-registry.dev/
2. Add it to ensure_installed in nvim/lua/plugins/mason.lua
3. Add the filetype → formatter mapping in nvim/lua/plugins/formatting.lua

The tmux config includes:

set -as terminal-features ",alacritty:clipboard"

This enables OSC 52 clipboard passthrough specifically for Alacritty. Change alacritty to match your terminal if different (e.g. xterm-256color, kitty, wezterm). Most modern terminals support OSC 52 by default and may not need this line.

Edit nvim/lua/plugins/vim-rooter.lua → rooter_patterns to add markers for your project structure (e.g. pyproject.toml, go.mod).

Icons look like boxes or question marks → Install a Nerd Font and configure it in your terminal emulator.

Formatters not working → Run :ConformInfo in Neovim — it shows which formatters are found vs missing. → Check prettier and sql-formatter are on PATH: which prettier. → Check language runtimes are installed (java -version, python3 --version, clang-format --version).

Mason tools not installing → Check runtimes above are installed. → If on a corporate network with a private npm registry, install prettier and sql-formatter via brew install instead of Mason.

Plugins not loading in Neovim → Run :Lazy sync to force a full sync. → Ensure git is installed and you have internet access.

tmux plugins not loading → Press prefix I inside tmux, or run manually:

~/.tmux/plugins/tpm/bin/install_plugins

Clipboard not working from Neovim → Requires Neovim 0.10+ and a terminal that supports OSC 52. → If broken, delete nvim/lua/plugins/clipboard.lua — Neovim falls back to pbcopy (macOS), xclip/xsel (Linux), or the Windows clipboard. → On macOS without tmux, clipboard usually works out of the box without this file.

google-java-format fails → Ensure Java 11+ is installed: java -version → On macOS: brew install openjdk && brew link openjdk

clang-format not found → macOS: xcode-select --install → Linux: sudo apt install clang-format or brew install llvm → Windows: scoop install llvm