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

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

## Установка

```bash
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` — что панель видит: логи хука, причины скрытия сессий,
ошибки лимитов и баланса.

## Удаление

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