convez.ai
Agente
kaiiserni

tmux-agent-dashboard

kaiiserni/tmux-agent-dashboard

Ver no GitHub
InicialPluginScore · de 0 a 100

tmux popup dashboard for Claude Code / Codex agents

Instalação

$npx convez-ai kaiiserni/tmux-agent-dashboard

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

tmux-agent-dashboard

A tmux popup dashboard for Claude Code / Codex / OpenCode agents. Shows aggregate counters, attention / waiting / responded lists on the left, running / idle lists on the right, and a global recent-activity feed at the bottom. Also includes a tiles grid view for a quick visual overview.

Dependency

Requires tmux-agent-sidebar installed and running. The dashboard is a pure consumer — every pane metadata value comes from the tmux options and activity logs that the sidebar plugin's hooks write.

Install

TPM (build from source)

set -g @plugin 'kaiiserni/tmux-agent-dashboard'

After prefix + I, run cargo build --release inside the plugin directory so the binary lands in target/release/.

Manual

git clone https://github.com/kaiiserni/tmux-agent-dashboard.git \
  ~/projects/tmux-agent-dashboard
cd ~/projects/tmux-agent-dashboard
cargo build --release

In ~/.tmux.conf:

run-shell '~/projects/tmux-agent-dashboard/tmux-agent-dashboard.tmux'

Keybindings

KeyAction
prefix + ñOpen dashboard popup
TabSwitch between Summary and Tiles
sToggle attention-first sort
pToggle redact mode (hide ages/timestamps + mask text, for screenshots)
j / k / ↓ / ↑Move row selection (auto-scrolls across lists)
h / l / ← / →Jump between columns (Summary view)
g / GJump to first / last row (Summary)
PageDown / PageUpScroll the active list
Enter or clickActivate pane and close popup
SpaceJump to the top pane that needs attention and close popup
LJump back to the origin pane (toggles back on a second press)
Mouse wheelScroll the list under the cursor
q / EscClose popup

The header items are clickable too: clicking one runs the matching key (and clicking the tab label or Tab: switch flips the view).

Each tile in the Tiles view also shows a context-preview line: the pane's most recent activity-log entry (tool, label, and age). Hidden in redact mode.

Configuration

set -g @dashboard_key    'ñ'      # default
set -g @dashboard_width  '90%'    # default
set -g @dashboard_height '85%'    # default

The sidebar's @sidebar_color_* and @sidebar_icon_* options are reused so visual customisation carries over.

Notifications

A background daemon can push a Google Chat message whenever a pane transitions into an attention-worthy state (an explicit attention flag, or status Waiting / Error) — handy when you work remotely over mosh/ssh and don't want to keep opening the popup.

  1. In Google Chat, open the target space → space name → Apps & integrations → Webhooks → Add webhook, and copy the URL.

  2. Point the dashboard at it:

    set -g @dashboard_notify_webhook 'https://chat.googleapis.com/v1/spaces/AAAA/messages?key=...&token=...'
    

    (Or export DASHBOARD_NOTIFY_WEBHOOK in the environment as a fallback.)

When @dashboard_notify_webhook is set, the plugin auto-starts the daemon on load (guarded against duplicate instances via /tmp/tmux-agent-dashboard-notify.pid). It polls every ~5s and applies a 60s per-pane cooldown so a flapping pane won't spam the space.

Run it standalone:

tmux-agent-dashboard notify-daemon

Messages look like ⚠ auth refactor (cc-helion:editor) — waiting · …, using the friendly pane name when set. Activity is appended to /tmp/tmux-agent-dashboard-notify.log (start/stop and sent notifications; the webhook URL is never logged). With no webhook configured the daemon exits with a message on stderr.

Architecture

  • prefix + ñ triggers tmux display-popup -E "<bin>" which runs the Rust TUI
  • The TUI reads tmux list-panes -F for pane state and /tmp/tmux-agent-activity*.log for the recent activity feed
  • seen <pane_id> (bound to after-select-pane) writes @pane_last_seen_at so the dashboard can derive when you last looked at a pane — the basis for the Responded heuristic

Build from source

macOS (arm64):

cd ~/projects/tmux-agent-dashboard
cargo build --release
cp target/release/tmux-agent-dashboard bin/
codesign --force --sign - bin/tmux-agent-dashboard

Linux: cargo build --release is enough; no codesigning needed.

License

MIT

Ver o original no GitHub

Bom para

Relacionados