Claude — панель для iTerm2 Toolbelt

Сверху — дерево активных сессий Claude Code и их субагентов (модель, контекст, worktree), снизу — лимиты подписки и баланс extra usage.

Установка

tar xzf claude-panel.tar.gz
cd claude-panel
./install.sh

Затем в iTerm2: View → Toolbelt → Show Toolbelt, Toolbelt → Claude, и перезапустите открытые сессии claude. Повторный запуск install.sh обновляет установленное.

Нужно: macOS, iTerm2, python3, jq (brew install jq, в macOS 15+ уже есть).

Что ставится

Что	Куда
скрипт панели	~/Library/Application Support/iTerm2/Scripts/AutoLaunch/claude_agents.py
хук Claude Code	~/.claude/hooks/agents_panel_hook.sh + записи в ~/.claude/settings.json
пример настроек	~/.config/claude-agents/config.example.json

Перед изменением settings.json и заменой файлов старые копии кладутся в ~/.claude-panel-backup/<дата>/. Ваши остальные хуки и настройки не трогаются.

Работа с панелью

• клик по сессии или агенту — последние сообщения (копятся, пока окно открыто);
• ⌘-клик по сессии — перейти в её вкладку;
• клик по ⎇ папка — открыть в ней lf в соседней панели;
• цвет точки: зелёный — работает, жёлтый — ждёт вас, серый — свободен;
• сессии внутри tmux (и tmux -CC) тоже видны: клик по ⎇ делит панель tmux, ⌘-клик переключает на неё;
• цвет токенов: жёлтый > 500k, красный > 700k.

Настройки

Скопируйте config.example.json в ~/.config/claude-agents/config.json и оставьте только нужные ключи. Меняется на лету, кроме port.

Если что-то не так

http://127.0.0.1:8766/raw — что панель видит: логи хука, причины скрытия сессий, ошибки лимитов и баланса.

Удаление

./uninstall.sh          # настройки и логи остаются
./uninstall.sh --purge  # удалить всё