К основному содержанию
плагин

tmux-status — плагин для Claude Code: что делает и как установить

Плагин tmux-status выводит текущее состояние Claude Code иконкой в заголовке окна tmux. Вы сразу видите, ждёт ли агент подтверждения или выполняет задачу, не переключаясь на вкладку.

MIT ★ 6 обновлён 2026-08-10

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install tmux-status@claude-community
Открыть на GitHub

Что делает tmux-status

Плагин подвязывается к событиям жизненного цикла Claude Code через встроенные хуки. При запуске сессии, отправке промпта или запросе разрешений срабатывает короткий bash-скрипт, который дописывает суффикс к названию окна tmux. Фонового демона нет: скрипт выполняется по событию и сразу завершает работу.

Если задать имя сессии через /rename, плагин подставит его в заголовок окна перед индикатором. После завершения сессии исходное имя окна возвращается на место. При этом настройка automatic-rename в tmux остаётся нетронутой.

Для работы требуются установленный tmux и CLI Claude Code. Набор значков можно менять на лету командой /tmux-icons: кроме стандартных эмодзи поддерживаются символы nerd-font и текстовый набор minimal.

Какие задачи решает

  • отслеживать статус Claude Code в фоне без перехода в окно терминала
  • замечать запросы разрешений и системные уведомления агента
  • различать активную работу с кодом и состояние ожидания
  • возвращать прежние имена окон tmux после закрытия сессии

Примеры запросов агенту

  • /tmux-icons nerd-font
  • /tmux-icons set attention !!
  • /tmux-icons minimal

Как установить tmux-status

Через маркетплейс плагинов

/plugin marketplace add anthropics/claude-plugins-community
/plugin install tmux-status@claude-community

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о tmux-status

Как установить tmux-status в Claude Code?

В Claude Code выполните команду подключения каталога /plugin marketplace add anthropics/claude-plugins-community, а затем установите сам плагин: /plugin install tmux-status@claude-community.

Что делает плагин tmux-status?

Он добавляет значок статуса в имя окна tmux, показывая, занят ли Claude Code обработкой задачи или ждёт ответа пользователя.

Влияет ли плагин на встроенное переименование окон tmux?

Нет, параметр automatic-rename плагин не трогает, а при выходе из сессии Claude Code возвращает окну его прежнее имя.

Исходный текст

SKILL.md · MIT
# claude-tmux-status
<img width="620" height="57" alt="image" src="https://github.com/user-attachments/assets/883a7881-60a4-41f9-96b5-1ac4e185dffe" />

A [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin that shows session state as emoji icons in your tmux window name.

```
 zsh              — no session
 zsh [🧑‍🍳]          — thinking / tool use
 zsh [👀]          — needs attention (permission request / notification)
 zsh [😴]          — idle
```

Name your session with `/rename` and the window follows along:

```
 Fix auth bug [🧑‍🍳]    — window named after the Claude session
```

## Requirements

- [tmux](https://github.com/tmux/tmux)
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI

## Install

### Via Claude Code Plugin Marketplace (recommended)

From inside Claude Code, run:

```
/plugin marketplace add https://github.com/haxybaxy/claude-tmux-status.git
```

Then install the plugin:

```
/plugin install tmux-status
```

Finally, activate it:

```
/reload-plugins
```

### Manual

Clone into your Claude Code plugins directory:

```bash
git clone https://github.com/haxybaxy/claude-tmux-status \
  ~/.claude/plugins/claude-tmux-status
```

Claude Code picks up the plugin automatically on next launch.

## How it works

The plugin registers [hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) for Claude Code lifecycle events. Each event runs a small bash script that appends or removes an icon suffix on the current tmux window name.

There is no background process — the script runs only when a hook fires, and exits.

| Event               | Icon        | State                                       |
| ------------------- | ----------- | ------------------------------------------- |
| `SessionStart`      | `😴`        | Idle                                        |
| `UserPromptSubmit`  | `🧑‍🍳`        | Processing                                  |
| `PreToolUse`        | `🧑‍🍳`        | Processing                                  |
| `PostToolUse`       | `🧑‍🍳`        | Processing                                  |
| `Stop`              | `😴`        | Idle                                        |
| `PermissionRequest` | `👀`        | Needs attention                             |
| `Notification`      | `👀`        | Needs attention                             |
| `SessionEnd`        | _(removed)_ | Restores the pre-session window name        |

### Window names

The text before the icon is the **Claude session title** — whatever you set with `/rename` — whenever tmux can see it. Otherwise the window keeps its own name.

When the session ends, the window name it had beforehand is put back.

Your `automatic-rename` setting is never modified, in either direction.

## Customization

### Switch icon themes

Use the built-in skill from inside Claude Code:

```
/tmux-icons              # list available themes
/tmux-icons emoji        # switch to emoji (default)
/tmux-icons nerd-font    # switch to Nerd Font icons
/tmux-icons minimal      # switch to plain text indicators
```

Changes take effect immediately on the next lifecycle event — no restart needed.

### Override a single icon

```
/tmux-icons set attention !!
```

### Create a custom theme

```
/tmux-icons create my-theme
```

### Bundled themes

| Theme       | Idle | Processing | Attention | Notes                      |
| ----------- | ---- | ---------- | --------- | -------------------------- |
| `emoji`     | 😴   | 🧑‍🍳         | 👀        | Default, works everywhere  |
| `nerd-font` | 󰒲    | 󰑮          | 󰂞         | Requires a patched font    |
| `minimal`   | zzz  | ...        | (!)       | Plain text, no font needed |

### Manual config

The active icon set is stored in `config/active.conf` as simple key=value pairs:

```
idle=😴
processing=🧑‍🍳
attention=👀
```

Theme presets live in `config/themes/*.json`.

### Keep your own window names

To ignore the Claude session title and always use the window's own name, add to `.tmux.conf`:

```tmux
set -g @claude_tmux_status_title off
```

Set it per-window with `set -w` instead.

## License

[MIT](LICENSE) © Zaid Alsaheb

© haxybaxy · MIT · haxybaxy/claude-tmux-status

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
tmux openclaw Даёт агенту доступ к живым tmux-сессиям: читать вывод панели, отправлять клавиши и текст, ждать появления строки в промпте. CX Codex +1 8 500установок tmux-terminal mikeyobrien Скилл tmux-terminal для Claude Code управляет интерактивными терминальными сессиями через tmux: отправляет клавиши, считывает вывод и оставляет процессы работать между шагами. Работает с TUI и долгими CLI-задачами. CX Codex +1 ★ 3 206звёзд репо using-tmux-for-interactive-commands obra Скилл using-tmux-for-interactive-commands для Claude Code и других агентов: учит запускать vim, REPL и интерактивный git rebase через отсоединённые сессии tmux — там, где обычный bash зависает. CX Codex +1 515установок tmux-cli pchalasani Скилл tmux-cli даёт агенту доступ к командам в других панелях tmux. Он пригодится для запуска тестов, сборок и обмена сообщениями между CLI-агентами. CX Codex +1 ★ 2 039звёзд репо smux ShawnPana Скилл smux связывает агентов в сессиях tmux и управляет панелями терминала через утилиту tmux-bridge. Пригодится при параллельной работе нескольких процессов. CX Codex +1 2 900установок control-cli cursor Скилл control-cli для Claude Code, Codex, Cursor и других агентов собирает локальный стенд для управления интерактивным CLI или TUI. Запускает детерминированные сценарии ввода, снимает транскрипты и профили — без сетевых зависимостей. CX Codex +1 2 700установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой