A tiny tmux plugin that shows what agents are up to in the status bar, and helps you navigate them with a fzf-tmux window.
| Glyph | State | Meaning |
|---|---|---|
! |
blocked | a dialog is waiting on you — permission, question, plan approval |
✔ |
unseen | finished a turn since you last looked at its window — the terminal sitting behind another app counts as not looking |
● |
working | busy right now |
○ |
idle | nothing running, nothing unread |
Yes. And some of them are even blazing-fast 🦞, agent-centric, or overhaul your entire workflow.
But I like my terminal the way it is, with tmux at the center, and everything else out of the way.
Paste the URL of this repo into your agent and install. no mistakes
Needs tmux, tpm, and fzf (with fzf-tmux).
1. The tmux plugin. With TPM
# add plugin
set -g @plugin 'libec/tmux-safehouse'
# configure fzf-window key, pressed after your prefix. Default: a
set -g @safehouse-key 'a'
# configure (optional) status-bar counter, renders as: ! 1 ✔ 2 ● 1 ○ 3
set -ag status-right '#{E:@safehouse_status}'Then reload plugins with prefix + I.
2. Claude Code.
claude plugin marketplace add https://github.com/libec/tmux-safehouse.git
claude plugin install tmux-safehouse@tmux-safehouse3. Codex.
codex plugin marketplace add https://github.com/libec/tmux-safehouse.git
codex plugin add tmux-safehouse@tmux-safehouse4. Approve hooks. Open /hooks in Codex and trust the seven Safehouse
hooks once.
5. Restart agents. Both Claude and Codex load plugins at startup.
MIT.
