gotacat.dev

AGENT DECK

Плагин для Stream Deck: шесть клавиш показывают, какие задачи агентов работают, ждут ответа или закончили.

Установить плагинКак я работаю с агентами

Нажмите на клавишу, как на Stream Deck.

Пока агент думает

Одна клавиша — одна задача. Не нужно обходить окна, чтобы узнать, какой агент ждёт вас.

  1. работаетCodex, контекст 12%

    Вы ставите Codex задачу и уходите в другое окно.

  2. ждёт ответаCodex, контекст 38%

    Агенту нужно ваше подтверждение. Клавиша горит жёлтым, пока вы не ответите.

  3. работаетCodex, контекст 41%

    Нажатие на клавишу открывает именно эту задачу. Вы ответили — агент снова работает.

  4. готовоCodex, контекст 63%

    Задача закончена. Галочка горит, пока вы не откроете результат.

Где работает

ИсточникmacOSWindowsЧто делает нажатие
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 или новее.

Шаги

  1. Откройте com.xonika9.codex-deck.streamDeckPlugin — Stream Deck установит плагин. В списке действий он называется Codex Deck.

  2. Распакуйте архив запускателя. Если node --version в Терминале ничего не показывает, установите Node.js 24 с nodejs.org.

  3. Откройте Терминал в папке codex-deck-launcher-macos и выполните три команды. Если Codex уже открыт, запускатель спросит разрешения на перезапуск — ответьте yes.

    ./start-codex-deck.sh dry-run
    ./start-codex-deck.sh self-test
    ./start-codex-deck.sh start
  4. В Codex откройте Settings → Codex Micro и настройте слоты. В Stream Deck перетащите действия Codex Deck на клавиши.

  5. В настройках действия Agent выберите источник Codex.

По желанию

Чтобы запускатель стартовал сам при входе в систему:

./start-codex-deck.sh install

Как понять, что всё работает

Клавиша Local Codex Connection показывает READY, клавиши Agent — ваши задачи Codex. Тёмный ряд — норма, пока активных задач нет. Если плагин не появился, перезапустите Stream Deck.

Как я работаю с агентами

Agent Deck вырос из моей ежедневной работы: несколько задач у агентов сразу, и ни одна не должна ждать меня молча.

О том, как я ставлю агентам задачи и проверяю их работу, пишу в блоге.