AGENT DECK
Плагин для Stream Deck: шесть клавиш показывают, какие задачи агентов работают, ждут ответа или закончили.
Установить плагинКак я работаю с агентамиНажмите на клавишу, как на Stream Deck.
Пока агент думает
Одна клавиша — одна задача. Не нужно обходить окна, чтобы узнать, какой агент ждёт вас.
- работаетCodex, контекст 12%
Вы ставите Codex задачу и уходите в другое окно.
- ждёт ответаCodex, контекст 38%
Агенту нужно ваше подтверждение. Клавиша горит жёлтым, пока вы не ответите.
- работаетCodex, контекст 41%
Нажатие на клавишу открывает именно эту задачу. Вы ответили — агент снова работает.
- готовоCodex, контекст 63%
Задача закончена. Галочка горит, пока вы не откроете результат.
Где работает
| Источник | macOS | Windows | Что делает нажатие |
|---|---|---|---|
| Codex | да | да | Открывает выбранную задачу. Кнопки Micro, джойстик, энкодер, уровень рассуждений и новая задача — тоже для Codex. |
| OpenCode | да | нет | Выводит OpenCode Desktop на передний план, задачу не выбирает. |
| T3 Code | да | нет | Выводит T3 Code на передний план, задачу не выбирает. |
На Windows — только локальный Codex. На macOS OpenCode и T3 Code подключаются и к удалённым Linux-машинам через сохранённые SSH-соединения.
Нужны Stream Deck 7.1 или новее, macOS 13+ или Windows 10+. Модель устройства и раскладку выбираете сами, плагин проверяли на Stream Deck MK.2 с 15 клавишами.
Установка
Поручить агенту
Скопируйте промпт и отдайте своему агенту — Codex, Claude Code, OpenCode или другому. Он проверит систему, спросит, что подключать, установит плагин и скажет, что осталось сделать руками.
Установи мне плагин Agent Deck для Elgato Stream Deck. Цель: плагин установлен, выбранные мной источники задач подключены, а я знаю, что осталось сделать руками и как проверить, что всё работает.
## Что известно о плагине
- Репозиторий: https://github.com/xonika9/agent-stream-deck. Файлы бери из последнего выпуска (https://github.com/xonika9/agent-stream-deck/releases/latest) и сверяй с его `SHA256SUMS.txt`.
- Подробные инструкции — `docs/MACOS.md`, `docs/WINDOWS.md`, `docs/OPENCODE_COMPATIBILITY.md` и `docs/T3CODE_COMPATIBILITY.md` в репозитории. Если они расходятся с этим текстом, верь им.
- Нужны приложение Stream Deck 7.1 или новее и macOS 13+ или Windows 10+. Другие системы не поддерживаются.
- Источники задач: на macOS — Codex, OpenCode и T3 Code, на Windows — только локальный Codex.
- Плагин — файл `com.xonika9.codex-deck.streamDeckPlugin`: если его открыть, Stream Deck сам предложит установку. В Stream Deck плагин называется Codex Deck.
- Codex: нужны настольное приложение Codex, Node.js 24 или новее и запускатель `codex-deck-launcher-<macos|windows>-<версия>.zip` из выпуска.
- macOS: в распакованной папке `./start-codex-deck.sh dry-run`, `./start-codex-deck.sh self-test`, `./start-codex-deck.sh start`. Автозапуск при входе — `./start-codex-deck.sh install`.
- Windows: `.\Start-CodexDeck.ps1 -DryRun`, затем «Start Codex Deck.cmd». Автозапуск — `.\Start-CodexDeck.ps1 -InstallStartup`.
- Если Codex уже открыт, запускатель перезапустит его.
- OpenCode (только macOS): нужен OpenCode Desktop с запущенной локальной службой. Запускатель не нужен; остановленную службу плагин не запускает.
- T3 Code (только macOS): подключение делается из исходного кода — клонировать репозиторий, `npm ci` и при запущенном T3 Code выполнить `t3 auth pairing create --label CodexDeck --json | npm run connect:t3`. Команда создаёт отдельную сессию только для чтения.
## Что сделать
Выясни сам: систему и её версию, установлен ли Stream Deck и какой версии, какие из Codex, OpenCode и T3 Code есть на компьютере, есть ли Node.js 24+ и Git (Git нужен только для T3 Code). Чего не можешь выяснить — спроси меня. Затем спроси, какие из найденных источников подключить и нужен ли автозапуск, и установи только это.
## Границы
- Спроси меня, прежде чем перезапускать Codex (это прервёт его текущие задачи), устанавливать Node.js или другие программы, использовать sudo или права администратора и клонировать репозиторий для T3 Code.
- Не меняй настройки Codex, Stream Deck и других приложений сверх установки плагина и никуда не отправляй мои данные.
- Если шаг не удался, остановись на нём, покажи ошибку и предложи варианты; не обходи проблему отключением проверок.
## Что останется мне
Этого ты сделать не можешь — скажи мне в конце:
- подтвердить установку плагина в окне Stream Deck, если оно появилось;
- в Codex: Settings → Codex Micro, настроить слоты (если подключён Codex);
- в Stream Deck: перетащить действия Codex Deck на клавиши и в настройках действия Agent выбрать источник: `Codex`, `OpenCode`, `T3 Code` или `All`.
## Отчёт
Короткая сводка: что нашёл (система, Stream Deck, источники, Node.js), что установил и подключил, с версиями, чем подтверждено каждое подключение (для Codex результат проверок запускателя, для T3 Code вывод команды подключения, для OpenCode запущена ли локальная служба), что осталось сделать мне — по шагам, и как проверить результат. Признаки успеха: клавиши Agent показывают задачи подключённых источников, а если подключён Codex, клавиша Local Codex Connection показывает `READY`; тёмный ряд — норма, пока активных задач нет; если плагин не появился, нужно перезапустить Stream Deck.Промпт длиннее — прокрутите. Кнопка копирует его целиком.
Или по шагам
Понадобится: Настольное приложение Codex и Node.js 24 или новее.
Скачать
Шаги
Откройте
com.xonika9.codex-deck.streamDeckPlugin— Stream Deck установит плагин. В списке действий он называется Codex Deck.Распакуйте архив запускателя. Если
node --versionв Терминале ничего не показывает, установите Node.js 24 с nodejs.org.Откройте Терминал в папке
codex-deck-launcher-macosи выполните три команды. Если Codex уже открыт, запускатель спросит разрешения на перезапуск — ответьтеyes../start-codex-deck.sh dry-run ./start-codex-deck.sh self-test ./start-codex-deck.sh startВ Codex откройте Settings → Codex Micro и настройте слоты. В Stream Deck перетащите действия Codex Deck на клавиши.
В настройках действия Agent выберите источник
Codex.
По желанию
Чтобы запускатель стартовал сам при входе в систему:
./start-codex-deck.sh installКак понять, что всё работает
Клавиша Local Codex Connection показывает READY, клавиши Agent — ваши задачи Codex. Тёмный ряд — норма, пока активных задач нет. Если плагин не появился, перезапустите Stream Deck.