tmux process list & agent alerts

something i wanted to showcase from my dotfiles

a process list and alert system built on plain tmux and zsh, a single fzf switcher over every command i’m watching across my sessions: running tests, builds, and servers show as live rows with elapsed time, finished ones as pass/fail/stopped icons. from the picker i’m able to jump to a process’s window, interrupt a running one or dismiss a finished one, or rerun a finished command, either staging or running it straight away.

it’s all powered by one central layer, an alerts system. a zsh precmd hook flags any command that finishes in a pane which no client is currently viewing, highlighting the window tab green or red and showing a pass/fail icon on the status bar for other sessions. coding agents hook into it the same way: when Claude Code, Codex, or Copilot stops and waits for input, a thin per-agent wrapper raises a status-bar icon; OpenCode, which exposes no shell hooks, only a plugin API, feeds the same alerts through a plugin i published separately. alerts clear automatically upon switching back to the window, and adding a new agent is just another pair of wrapper scripts.

the same picker pattern runs across the rest of my setup: per-agent and per-editor switchers list every running neovim, Claude, Codex, OpenCode or Copilot instance across my tmux sessions, so i can jump straight to one, spawn a new one in place, or kill it without leaving the keyboard. the process list, the alerts, and these pickers all stem from the same core idea; the ability to, in one keystroke, see everything i’ve got running and be able to act on it.