convez.ai
AgenteProdutividadeIntermediário
3axap4eHko

tmux-select

3axap4eHko/tmux-select

Seletor de janelas tmux com visibilidade de agentes de IA integrada

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent inteligente para tmux que integra um fuzzy finder nativo e mostra o estado em tempo real de agentes de IA (Claude Code, Codex) rodando em cada janela. Permite pular direto para panes bloqueados que precisam de input, sem precisar de fzf externo.

Instalação

$npx convez-ai 3axap4eHko/tmux-select

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
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 dias
Versão
v0.0.12
Issues abertas
2
Contribuidores
1

Casos de uso

  • Navegar rapidamente entre múltiplas sessões de coding com IA em tmux
  • Identificar janelas com agentes bloqueados aguardando input
  • Filtrar janelas por estado do agente (blocked, working, idle)

Veredito

Ferramenta altamente especializada e bem implementada para quem trabalha com tmux + agentes Claude. O fuzzy finder integrado em Rust e a detecção de estado de agentes via /proc é elegante, mas o escopo é nicho (Linux como primeira classe, outros SOs com fallback). Recomendado para desenvolvedores que usam tmux intensivamente com Claude Code.

README

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

tmux-select

An agent-aware tmux window picker. It replaces the usual list-windows | fzf | select-window binding with a picker that annotates each window with the live state of any AI coding agents (Claude Code, Codex) running in its panes, so you can see at a glance which window needs your attention and jump straight to the pane that is blocked.

https://github.com/user-attachments/assets/74f50ead-c774-462d-a619-862d38bb2888

It lists the windows of the current tmux session, ordered by window index. Pick one and it switches to it; if a pane there is blocked, it focuses the first blocked pane so you land exactly where input is needed.

Requirements

  • tmux (developed against 3.5a) - the only runtime dependency; the fuzzy finder is built in (no fzf required)
  • Rust (edition 2024) to build from source

Linux is fully supported. On other platforms the build works, but agent classification falls back to the pane's foreground command name (the process-tree walk needs /proc).

Install

From crates.io:

cargo install --locked tmux-select

Or from a local checkout:

cargo install --locked --path .
# or: cargo build --locked --release  (binary at target/release/tmux-select)

Then bind it in ~/.tmux.conf:

bind / display-popup -E "tmux-select"

Press your prefix then / to open the picker. The -E flag closes the popup automatically when the picker exits.

tmux-select must run inside a tmux session (it reads $TMUX); launching it from a plain shell exits with an error. The display-popup binding always satisfies this.

Usage

The picker opens with every window of the current session listed. Type to fuzzy-filter, move with the arrow keys, press Enter to switch.

Keys

KeyAction
Enterswitch to the selected window
Up / Ctrl-Pmove selection up
Down / Ctrl-Nmove selection down
any characterappend to the filter query
Backspacedelete the last query character
Ctrl-Uclear the query
Esc / Ctrl-C / Ctrl-Gcancel without switching

Agent states

Each agent pane in a window is annotated as [<agent>: <state>]:

  • blocked - the agent is paused on a prompt or approval and needs input. Selecting the window jumps to that pane.
  • working - the agent is actively running.
  • idle - the agent is at its prompt with nothing in progress.

Filtering by state

The fuzzy filter matches against the whole line, including the annotations, so typing blocked narrows the list to exactly the windows needing input. This is the fastest way to find what needs attention, since windows stay in index order rather than sorting blocked ones to the top.

License

Licensed under the Apache License, Version 2.0. Copyright 2026 Ivan Zakharchanka. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados