gs

Tmux Agent Status — Development skill for Claude Code

Development community

Quiet tmux status for Claude Code, Codex, opencode & pi — shows nothing while agents work, a small marker when one needs you.

How to install Tmux Agent Status

This entry records only its repository, not the path inside it, so there is no exact command to give. Open gs/tmux-agent-status and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tmux Agent Status does

Quiet tmux status for Claude Code, Codex, opencode & pi — shows nothing while agents work, a small marker when one needs you. No dashboard, no daemon.

Alternatives in Development

  • Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★
  • Codeman — Manage Claude Code & Opencode in Tmux Sessions in a modern WebUI 329 ★
  • Mulmoterminal — Run multiple Claude Code and Codex sessions in parallel — a browser terminal grid that shows which agent needs 187 ★

README

tmux-agent-status

[![ci](https://github.com/gs/tmux-agent-status/actions/workflows/ci.yml/badge.svg)](https://github.com/gs/tmux-agent-status/actions/workflows/ci.yml) [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![tmux >= 3.2](https://img.shields.io/badge/tmux-%E2%89%A5%203.2-1bb91f.svg)](#requirements)

**The anti-dashboard for AI coding agents in tmux.** No sidebar, no live feed of prompts and tool calls, no desktop notifications, no daemon. For Claude Code, Codex, opencode and pi: nothing is shown while an agent works. When one needs you — blocked on a permission, or just finished — you get a small marker in the bar, plus a searchable popup to jump straight to it. **It lives entirely inside tmux.**

tmux-agent-status demo: the bar stays silent while agents work, codex finishing shows a quiet checkmark, claude blocking on a permission prompt shows a warning marker, prefix+a opens a searchable popup across every session with a live preview, and enter jumps straight to the blocked pane

What you see

Three states, and only two of them ever show up. Working is deliberately invisible.

state meaning bar / window marker banner (optional)
working agent busy nothing never
waiting blocked on a permission or a question ⚠N / ⚠ yes, unless you're already looking at it
done finished, you haven't looked yet ✓N / ✓ never

1. Silent until something needs you

The bar at three moments: five agents working (nothing shown), `codex` finishing (a quiet `✓`), and `claude` blocking on a permission prompt in another session (`⚠`). The `✓` clears the moment you focus that pane, with nothing to dismiss.

![The three bar states](docs/img/states.png)

2. When an agent needs you

The `⚠` stays in the bar until you deal with it. If you want a nudge as well, turn on the banner (`set -g @agent-status-banner o