dotfiles

My portable terminal environment: zsh + Oh My Posh (atomic) + fzf + autosuggestions + syntax highlighting, plus git and Alacritty configs. One command sets up any fresh Fedora or Debian/Ubuntu machine — and on Windows, install.ps1 for the native side plus WSL for the same zsh shell. No macOS: there is no Mac in the fleet (support dropped 2026-09-14).

Quick start

git clone https://github.com/jacedeno/dotfiles.git ~/repos/dotfiles
cd ~/repos/dotfiles
./install.sh
exec zsh

install.sh is idempotent — safe to re-run any time. It never overwrites your existing files: anything in the way is moved to ~/.dotfiles-backup/<timestamp>/.

What it does

1. Installs packages: zsh, git, curl, fzf, unzip, tree, ranger via dnf (Fedora) or apt (Debian/Ubuntu).

2. Installs Oh My Posh with the upstream installer into ~/.local/bin and pins the atomic theme locally (~/.config/ohmyposh/atomic.omp.json) so the prompt works offline.

3. Clones zsh-autosuggestions and zsh-syntax-highlighting into ~/.zsh/plugins/.

4. Symlinks the dotfiles into place:

   Repo file	Symlinked to
   zsh/.zshrc	~/.zshrc
   git/.gitconfig	~/.gitconfig
   git/hooks	~/.config/git/hooks (global core.hooksPath; commit-msg rejects AI attribution)
   ranger/rc.conf	~/.config/ranger/rc.conf (overrides only: git status shown next to files)
   alacritty/alacritty.toml	~/.config/alacritty/alacritty.toml (only if Alacritty is installed)
   environment.d/10-local-bin.conf	~/.config/environment.d/10-local-bin.conf (only if systemctl is present) — puts ~/.local/bin on PATH for GUI/dbus-launched apps, which never source ~/.zshrc. Takes effect on next login.
   bin/clip2forge	~/.local/bin/clip2forge
   bin/mount-excemca	~/.local/bin/mount-excemca
   claude/statusline.py	~/.claude/statusline/statusline.py — Claude Code's status line; install.sh also adds the statusLine key to ~/.claude/settings.json if it is missing (see Claude Code status line)

5. Creates an empty ~/.zshrc.local for machine-specific config. Git identity and other machine-specific git settings go in ~/.gitconfig.local (untracked), which the tracked .gitconfig includes last so its values win.

Notes

• No terminal emulator is installed: alacritty/alacritty.toml is linked only if Alacritty is already present.
• Oh My Zsh is not used. If a machine already has it, install.sh backs up the old ~/.zshrc; ~/.oh-my-zsh is left untouched, so reverting is just a matter of restoring the backup.

Layout

├── install.sh                # setup script (Fedora + Debian/Ubuntu)
├── install.ps1               # setup script (Windows-native: git, font, prompt, profile)
├── zsh/.zshrc                # portable zshrc — degrades gracefully if a tool is missing
├── git/.gitconfig
├── alacritty/alacritty.toml  # the terminal — Tokyo Night on black, launches herdr
├── environment.d/10-local-bin.conf  # puts ~/.local/bin on PATH for GUI/dbus-launched apps (systemd --user)
├── bin/clip2forge            # push desktop clipboard to GeekForge (Wayland/X11)
├── bin/mount-excemca         # mount a GeekLab SMB share — excemca (default) or -f for Family Share
├── bin/herdr-update          # update herdr from inside a herdr pane — live handoff, panes survive
├── claude/statusline.py      # Claude Code status line — model, effort, repo/branch, context bar, cost, cache, rate limits
├── ohmyposh/atomic.omp.json  # vendored theme, copied to ~/.config/ohmyposh/
├── ranger/rc.conf            # ranger overrides only — git status next to files (vcs_aware)
├── docs/
│   └── ranger.md             # tree + ranger: browsing files as a hierarchy in the terminal, keys and usage
├── machines/                 # per-machine hardware notes (docs only, never installed)
│   ├── gimble.md             # Chromebook + MrChromebox running Fedora — Alacritty+herdr, default terminal
│   └── ThinkPadT470.md       # personal work laptop, Fedora — Alacritty+herdr terminal swap
└── windows/
    └── Microsoft.PowerShell_profile.ps1   # light native-Windows profile (installed by install.ps1)

Machines

The configs are portable by design, but some boxes need workarounds a dotfile cannot carry — firmware quirks, driver overrides, hardware that only half works. Those are documented in machines/, which install.sh never touches.

Machine	Notes
gimble	Google Chromebook reflashed with MrChromebox, running Fedora. Touchpad scroll tuning, dead webcam, Bluetooth workarounds. Also on Alacritty + herdr, and the only machine where it is GNOME's default terminal (needs xdg-terminal-exec).
ThinkPadT470	Personal work laptop, Fedora. First machine on Alacritty + herdr instead of WezTerm — herdr owns tabs/splits/persistence since Alacritty has none.

Terminal: Alacritty + herdr

Alacritty is the emulator; it has no tabs or panes of its own, so alacritty/alacritty.toml sets terminal.shell = herdr and every window attaches to herdr's persistent local session. Splits, tabs and detach are herdr's bindings (ctrl+b prefix), not Alacritty's — see herdr's own docs.

What the repo config binds directly:

Keys	Action
Ctrl+Shift+K	Toggle vi mode — select and copy with the keyboard
Right click	Paste

To get a plain zsh with no herdr in the way: alacritty -e /usr/bin/zsh.

Updating herdr

herdr update refuses to run from inside a herdr pane, and with terminal.shell = herdr every Alacritty window is one. Run herdr-update (from bin/, on ~/.local/bin) instead. It strips the HERDR_* variables the guard looks at, updates with --handoff so the running server hands its live panes to the new binary (nothing is killed, not even a claude session doing the update), then reinstalls the agent hooks herdr asks for and prints herdr status. herdr-update --check only compares versions. The update shell function (zsh/.zshrc) runs it last, after the package manager, oh-my-posh upgrade, a git pull of each zsh plugin and claude update, so one command refreshes everything, including the tools the package manager does not know about.

Copying out of a full-screen TUI (claude, vim, k9s) needs one of these: the app captures the mouse, so dragging selects nothing. Either hold Shift while dragging to bypass mouse reporting, or skip the mouse entirely with Ctrl+Shift+K. This is the single most-forgotten thing in this config, which is why it is written down here.

Claude Code status line

The three rows under Claude Code's prompt are not a built-in: they come from claude/statusline.py, which Claude Code runs on every refresh with the session JSON on stdin. It was written on GeekForge (2026-09-10) and moved here on 2026-09-21 so every machine shows the same thing.

Row	Contents
1	Model, effort level, [fast/think] tags, owner/repo (or the cwd basename outside a repo), git branch with +staged ~dirty or clean
2	Context bar and percentage (green → yellow at 70% → red at 90%), tokens in context / window size, session cost in USD, wall time and API time, +lines/-lines when there are edits
3	Prompt cache (warm/cold, hit ratio, TTL) and the 5-hour / 7-day rate limits with time to reset

install.sh symlinks the script to ~/.claude/statusline/statusline.py and, if ~/.claude/settings.json has no statusLine key yet, adds this one (other keys are untouched; an existing statusLine is never replaced):

"statusLine": {
  "type": "command",
  "command": "/home/<user>/.claude/statusline/statusline.py",
  "padding": 0,
  "refreshInterval": 60
}

Notes:

• Needs python3 only — no packages. git status is cached for 5 s in /tmp/claude-1000/statusline-git.cache because it is slow on big repos.
• Secondary text uses plain white (\033[37m), not ANSI dim: dim is nearly invisible on the dark theme. Bump to \033[97m if it still reads too faint.
• To try a change without a live session, feed it a saved payload: ./claude/statusline.py < payload.json. To capture one, point statusLine.command at a wrapper like tee /tmp/payload.json | ~/.claude/statusline/statusline.py for a session, then switch it back.
• Row 2's token count is what the conversation occupies now, not the session total. Row 3's segments appear only when the payload carries them (older Claude Code versions send no prompt_cache or rate_limits).

Design notes

• Portable core, local overrides. ~/.zshrc is identical on every machine. Anything machine-specific (nvm, PlatformIO, work PATHs, extra aliases) lives in ~/.zshrc.local, which is sourced last and never committed.
• Guards everywhere. Every tool integration (oh-my-posh, fzf, kubectl, plugins) is wrapped in existence checks, so the same zshrc works on a minimal server and a full workstation.
• Platform-neutral package aliases. pkgi / pkgu / pkgr / pkgs map to dnf on Fedora and apt on Debian/Ubuntu.
• Probe, don't assume. The zshrc tests for a tool instead of branching on the OS: ports uses ss where present, else lsof.
• Nerd Font required for the prompt glyphs. Everything expects FiraCode Nerd Font Mono. Grab it from nerdfonts.com if the prompt shows broken symbols.

Windows

The shell on Windows is WSL — it runs the exact same zsh + dotfiles as the Linux machines, so aliases, prompt and config are identical with nothing duplicated. The native side (git, Nerd Font, prompt, PowerShell profile) is set up by install.ps1. No terminal emulator is installed: Windows Terminal already ships with Windows.

# from the repo root, in PowerShell:
.\install.ps1

install.ps1 is idempotent and backs up anything it replaces. It installs Git + Oh My Posh via winget, the FiraCode Nerd Font via oh-my-posh font install, and dot-sources windows/Microsoft.PowerShell_profile.ps1 from $PROFILE.

Then set up the shell in WSL (the same zsh everywhere):

wsl --install -d Debian          # admin; skip if WSL is already set up

# inside WSL:
git clone https://github.com/jacedeno/dotfiles.git ~/repos/dotfiles
cd ~/repos/dotfiles && ./install.sh

Set the WSL distro as Windows Terminal's default profile to land straight in zsh; the PowerShell profile stays light for native tasks.