Runner на Windows

Как установить runner на компьютер с Windows, пройти мастер настройки, включить автозапуск, обновить и удалить runner. Что такое runner — на странице «Как работает runner».

Что понадобится

• Windows x64.
• Учётная запись на доске: логин и пароль.
• CLI хотя бы одного агента: claude, codex или opencode. Если его нет, мастер покажет команду установки. Для неё нужен Node.js.

Runner не требует прав администратора и работает от вашего пользователя Windows.

Скачать и запустить

В доске откройте Профиль → «Подключить раннер» и нажмите Скачать у «Windows (x64)». Доска отдаёт runner своей версии.

Запустите qw.exe двойным щелчком. Если Windows предупредит о неизвестном издателе, нажмите Подробнее → Выполнить в любом случае.

При первом запуске мастер настройки открывается в браузере. В окне консоли runner печатает адрес страницы: если браузер не открылся сам, скопируйте адрес туда. Не закрывайте окно консоли до конца настройки.

Повторно мастер можно открыть из PowerShell в папке с файлом:

.\qw.exe setup --web

qw или .\qw.exe

Мастер и подсказки runner пишут команды как qw …. В PowerShell запускайте их из папки, где лежит файл: .\qw.exe ….

Мастер настройки

Вопросы те же, что на Linux, только на странице в браузере: доска, агенты, аккаунты агентов и автозапуск. Что значит каждый вариант — в разделе «Мастер настройки» на странице «Runner на Linux».

Отличие одно: вход в аккаунт модели тоже идёт на странице. Мастер показывает ссылку, а иногда и код. Откройте ссылку, войдите под аккаунтом для runner и введите код или вставьте код со страницы входа обратно в мастер. Для OpenCode мастер спросит провайдера и его ключ API.

Новые программы видны только новым окнам

Если вы поставили Node.js или CLI агента, пока мастер открыт, мастер их может не найти. Закройте окно консоли и запустите qw.exe снова.

Автозапуск

Автозапуск включает мастер последним шагом или команды:

.\qw.exe autostart enable
.\qw.exe autostart start

enable копирует qw.exe в %LOCALAPPDATA%\QueueWarden\runner\ и создаёт задачу в Планировщике заданий Windows. Задача запускает runner в скрытом окне через 15 секунд после вашего входа в систему. Если runner упал, Планировщик перезапустит его до трёх раз с паузой в минуту.

Runner работает, пока вы вошли в Windows. После перезагрузки он ждёт вашего входа.

Остальные команды — status, stop, disable — на странице «Как работает runner». stop дожидается, пока runner мягко завершит текущие запуски.

.\qw.exe autostart status печатает имя задачи, её папку и состояние. Последние строки журнала показывает .\qw.exe logs. Сам журнал фонового runner — в этой папке, файлы stdout.log и stderr.log. При каждом старте прошлые журналы переименовываются в stdout.log.previous и stderr.log.previous.

Обновление

Автоматического обновления нет. Новую версию берите там же: Профиль → «Подключить раннер». Настройки, аккаунты и рабочие каталоги хранятся отдельно от qw.exe и при обновлении сохраняются.

Если включён автозапуск, выполните в PowerShell в папке с новым файлом:

.\qw.exe autostart stop
.\qw.exe autostart enable
.\qw.exe autostart start

enable заменит новым файлом копию, из которой работает задача Планировщика.

Если runner запущен в консоли, остановите его через Ctrl+C, замените файл и запустите снова.

Удаление

1. Уберите автозапуск. Команда остановит фоновый runner, удалит задачу Планировщика и копию runner:

   .\qw.exe autostart remove

2. Отзовите подключения к доскам. Имена подключений покажет .\qw.exe connections:

   .\qw.exe connections
   .\qw.exe disconnect <имя>

3. Удалите папки runner:

   • %APPDATA%\queuewarden — настройки, рабочие каталоги задач и журналы запусков;
   • %USERPROFILE%\.queuewarden — аккаунты моделей, в которые входил runner;
   • %LOCALAPPDATA%\QueueWarden — копия runner для автозапуска и её журналы.

Ваши собственные профили CLI, например %USERPROFILE%\.claude, при этом не затрагиваются. Если в рабочих каталогах задач осталось нужное, сохраните это до удаления.