A Serious Terminal on Windows 11

#Requires -Version 5.1
# bootstrap.ps1: the Windows half of a serious terminal.
# Installs WSL 2 with Debian, Alacritty and the FiraCode Nerd Font, and caps WSL's memory.
# Run it in PowerShell opened as Administrator:
#   Set-ExecutionPolicy -Scope Process Bypass -Force
#   .\bootstrap.ps1
# Safe to re-run: every step skips what is already there.
$ErrorActionPreference = 'Stop'
function Say($msg) { Write-Host "==> $msg" -ForegroundColor Cyan }

$admin = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()
         ).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
if (-not $admin) { Write-Warning 'Open PowerShell with "Run as administrator" and try again.'; exit 1 }

# --- 1. WSL 2 + Debian -------------------------------------------------------------
Say 'WSL (updating)'
wsl.exe --update | Out-Host
$distros = (wsl.exe --list --quiet 2>$null) -replace "`0", '' | Where-Object { $_ -match '\S' }
$needsReboot = $false
if (-not ($distros -match '^Debian')) {
    Say 'Debian'
    wsl.exe --install -d Debian --no-launch | Out-Host
    $needsReboot = $true
}
wsl.exe --set-default-version 2 | Out-Null

# --- 2. Memory cap -------------------------------------------------------------------
# WSL takes up to half the RAM by default and is slow to give it back.
$wslconfig = Join-Path $env:USERPROFILE '.wslconfig'
if (-not (Test-Path $wslconfig)) {
    Say 'WSL memory cap (8 GB)'
    "[wsl2]`nmemory=8GB`n`n[experimental]`nautoMemoryReclaim=gradual`n" |
        Set-Content -Path $wslconfig -Encoding ASCII
}

# --- 3. Alacritty --------------------------------------------------------------------
$have = winget list --id Alacritty.Alacritty --exact --accept-source-agreements 2>$null | Select-String 'Alacritty'
if (-not $have) {
    Say 'Alacritty'
    winget install --id Alacritty.Alacritty --exact --silent `
        --accept-package-agreements --accept-source-agreements | Out-Host
}

# --- 4. FiraCode Nerd Font (the icons in the prompt and the sidebar) ---------------------
$fontName = 'FiraCode Nerd Font Mono'
$fontKey  = 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts'
$haveFont = Get-ItemProperty -Path $fontKey | Get-Member -MemberType NoteProperty |
            Where-Object { $_.Name -like "$fontName*" }
if (-not $haveFont) {
    Say $fontName
    $zip = Join-Path $env:TEMP 'FiraCode-NF.zip'
    $dir = Join-Path $env:TEMP 'FiraCode-NF'
    Invoke-WebRequest -UseBasicParsing -OutFile $zip `
        -Uri 'https://github.com/ryanoasis/nerd-fonts/releases/latest/download/FiraCode.zip'
    Expand-Archive -Path $zip -DestinationPath $dir -Force
    foreach ($style in 'Regular', 'Bold') {
        $file = "FiraCodeNerdFontMono-$style.ttf"
        Copy-Item (Join-Path $dir $file) (Join-Path $env:WINDIR "Fonts\$file") -Force
        $label = if ($style -eq 'Regular') { $fontName } else { "$fontName $style" }
        Set-ItemProperty -Path $fontKey -Name "$label (TrueType)" -Value $file
    }
    Remove-Item $zip, $dir -Recurse -Force
}

Say 'Windows side done.'
if ($needsReboot) { Write-Host '  Restart Windows now: WSL was just installed.' -ForegroundColor Yellow }
Write-Host '  Next: open "Debian" from the Start menu, create your Linux user, and run terminal-setup.sh.'

#!/usr/bin/env bash
# terminal-setup.sh: a serious terminal inside WSL (Debian or Ubuntu).
# zsh + Oh My Posh + autosuggestions + syntax highlighting + fzf + herdr (with its
# sidebar), and, if Alacritty is installed on Windows, its config.
# Safe to re-run: every step skips what is already there.
set -euo pipefail

log() { printf '\033[1;34m==>\033[0m %s\n' "$*"; }
BIN="$HOME/.local/bin"
mkdir -p "$BIN"
export PATH="$BIN:$PATH"

# --- 1. Base packages ---------------------------------------------------------
log "Base packages"
sudo apt-get update -qq
sudo apt-get install -y -qq zsh git curl ca-certificates fzf unzip tree >/dev/null

# --- 2. Oh My Posh (the prompt) -----------------------------------------------
if ! command -v oh-my-posh >/dev/null; then
  log "Oh My Posh"
  curl -fsSL https://ohmyposh.dev/install.sh | bash -s -- -d "$BIN" >/dev/null
fi
mkdir -p "$HOME/.config/ohmyposh"
[ -f "$HOME/.config/ohmyposh/atomic.omp.json" ] || curl -fsSL -o "$HOME/.config/ohmyposh/atomic.omp.json" \
  https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/atomic.omp.json

# --- 3. zsh plugins -----------------------------------------------------------
for p in zsh-autosuggestions zsh-syntax-highlighting; do
  [ -d "$HOME/.zsh/plugins/$p" ] || {
    log "$p"
    git clone -q --depth 1 "https://github.com/zsh-users/$p" "$HOME/.zsh/plugins/$p"
  }
done

# --- 4. herdr (sessions, tabs and panes that survive closing the window) ------
if ! command -v herdr >/dev/null; then
  log "herdr"
  curl -fsSL https://herdr.dev/install.sh | sh >/dev/null
fi
if ! herdr plugin list 2>/dev/null | grep -q 'herdr-sidebar'; then
  log "herdr sidebar plugin"
  # Pin the latest release: a bare install tracks the main branch
  tag=$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/alexarthurs/herdr-sidebar/releases/latest)
  herdr plugin install alexarthurs/herdr-sidebar/plugins/herdr-sidebar --ref "${tag##*/}" --yes >/dev/null 2>&1
fi
cfg="$HOME/.config/herdr/config.toml"
mkdir -p "$(dirname "$cfg")"
grep -q 'herdr-sidebar.open-sidebar' "$cfg" 2>/dev/null || cat >> "$cfg" <<'EOF'

# Sidebar: Ctrl+B then f toggles it, d opens source control, Shift+F finds a file.
[[keys.command]]
key = "prefix+f"
type = "plugin_action"
command = "herdr-sidebar.open-sidebar"
description = "sidebar: toggle"

[[keys.command]]
key = "prefix+d"
type = "plugin_action"
command = "herdr-sidebar.show-git"
description = "sidebar: source control"

[[keys.command]]
key = "prefix+shift+f"
type = "plugin_action"
command = "herdr-sidebar.quick-open"
description = "sidebar: quick open file"
EOF

# --- 5. ~/.zshrc ----------------------------------------------------------------
marker="# terminal-setup.sh"
if ! grep -qF "$marker" "$HOME/.zshrc" 2>/dev/null; then
  [ -f "$HOME/.zshrc" ] && mv "$HOME/.zshrc" "$HOME/.zshrc.bak-$(date +%Y%m%d-%H%M%S)"
  log "~/.zshrc"
  cat > "$HOME/.zshrc" <<'EOF'
# terminal-setup.sh: edit freely; machine-specific lines go in ~/.zshrc.local
export PATH="$HOME/.local/bin:$PATH"
export EDITOR=nano

# History: large, shared between panes, no duplicates
HISTFILE=~/.zsh_history HISTSIZE=10000 SAVEHIST=10000
setopt SHARE_HISTORY HIST_IGNORE_ALL_DUPS HIST_REDUCE_BLANKS

# Completion menu you can move through with the arrow keys
autoload -Uz compinit && compinit
zstyle ':completion:*' menu select

# Prompt, suggestions from history, and fuzzy search (Ctrl+R, Ctrl+T, Alt+C)
eval "$(oh-my-posh init zsh --config ~/.config/ohmyposh/atomic.omp.json)"
source ~/.zsh/plugins/zsh-autosuggestions/zsh-autosuggestions.zsh
eval "$(fzf --zsh)"

# Navigation and listing
alias ..="cd .." ...="cd ../.."
alias ll="ls -lah --color=auto" la="ls -A --color=auto"
mkcd() { mkdir -p "$1" && cd "$1"; }

# Safer defaults: ask before overwriting or deleting
alias cp="cp -iv" mv="mv -iv" rm="rm -Iv"

# Git
alias gs="git status" ga="git add ." gc="git commit -m" gp="git push"
alias gl="git log --oneline --graph --decorate -15" gd="git diff"

# Packages and maintenance
alias pkgi="sudo apt install" pkgs="apt search" pkgr="sudo apt remove"
alias zconf='${EDITOR} ~/.zshrc' zreload='source ~/.zshrc'
update() {
  echo "==> apt";  sudo apt update && sudo apt upgrade -y
  echo "==> oh-my-posh"; oh-my-posh upgrade
  echo "==> herdr"; herdr update
  local p; for p in ~/.zsh/plugins/*/; do
    echo "==> $(basename "$p")"; git -C "$p" pull --ff-only -q
  done
}

[ -f ~/.zshrc.local ] && source ~/.zshrc.local
# Must be last: it wraps every widget defined above
source ~/.zsh/plugins/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh
EOF
fi

# --- 6. zsh as the login shell ------------------------------------------------
if [ "$(getent passwd "$USER" | cut -d: -f7)" != "$(command -v zsh)" ]; then
  log "zsh as your login shell"
  sudo chsh -s "$(command -v zsh)" "$USER"
fi

# --- 7. Alacritty on Windows: open this distro straight into herdr -------------
if grep -qi microsoft /proc/version 2>/dev/null && [ -x "/mnt/c/Program Files/Alacritty/alacritty.exe" ]; then
  appdata=$(wslpath "$(cmd.exe /c 'echo %APPDATA%' 2>/dev/null | tr -d '\r')")
  dst="$appdata/alacritty/alacritty.toml"
  if [ ! -f "$dst" ]; then
    log "Alacritty config ($dst)"
    mkdir -p "$(dirname "$dst")"
    cat > "$dst" <<EOF
[terminal.shell]
program = "wsl.exe"
args = ["-d", "$WSL_DISTRO_NAME", "--cd", "~", "-e", "sh", "-lc", 'export SHELL=$(command -v zsh); exec "\$HOME/.local/bin/herdr"']

[env]
TERM = "xterm-256color"

[font]
size = 12.0
normal = { family = "FiraCode Nerd Font Mono", style = "Regular" }

[scrolling]
history = 10000

[colors.primary]
background = "#000000"
foreground = "#c0caf5"

[colors.normal]
black = "#15161e"
red = "#f7768e"
green = "#9ece6a"
yellow = "#e0af68"
blue = "#7aa2f7"
magenta = "#bb9af7"
cyan = "#7dcfff"
white = "#a9b1d6"

[colors.bright]
black = "#414868"
red = "#f7768e"
green = "#9ece6a"
yellow = "#e0af68"
blue = "#7aa2f7"
magenta = "#bb9af7"
cyan = "#7dcfff"
white = "#c0caf5"

[mouse]
bindings = [{ mouse = "Right", action = "Paste" }]
EOF
  fi
fi

log "Done. Open Alacritty (or run: exec zsh)."