Сессии кода в чате

Раздел «Код» в zubriq.by/chat — это ZubrIQ Code без терминала: вы выбираете репозиторий и ставите задачу, агент правит код в отдельной ветке, а вы видите каждый его шаг и подтверждаете команды. Устроено как сессии на claude.ai/code: агент живёт не на вашем компьютере, а в изолированном окружении платформы.

Что нужно

1. Аккаунт ZubrIQ с организацией и деньгами на кошельке — расход агента списывается как обычный запрос по ключу API.
2. Репозиторий на git.artcloud.by и персональный токен к нему: GitLab → Настройки → Access Tokens, права read_api и write_repository. Токен вставляется один раз в чате: Настройки → Подключения → «GitLab · сессии кода». Хранится шифрованно; отозвать можно в GitLab в любой момент.

Как проходит сессия

1. Репозиторий и ветка. На экране «Код» выберите проект (поиск по имени) и базовую ветку — по умолчанию ветку по умолчанию репозитория.
2. Задача. Опишите словами, как коллеге: «добавь экспорт CSV в отчёт», «почини тесты в модуле оплаты». Нажмите «Начать сессию».
3. Раннер поднимается (обычно полминуты): платформа создаёт изолированный контейнер, клонирует репозиторий и создаёт рабочую ветку zq/….
4. Лента. Видно всё, что делает агент: размышления, какие файлы читает, правки диффом, команды и их вывод. Правки файлов агент делает без вопросов, а перед командами оболочки (npm test, git push…) спрашивает — кнопки «Разрешить», «Разрешать всегда», «Запретить».
5. На ходу. Пока агент работает, можно дописать ему в поле ввода — сообщение попадёт в текущий ход. «Стоп» прерывает ход, следующий вопрос — продолжает сессию.
6. Результат. Агент коммитит и пушит рабочую ветку в ваш репозиторий. Ссылки «Ветка» и «Открыть MR» ведут в GitLab; merge request открываете и ревьюите вы — агент этого не делает.

Страницу можно закрыть и открыть позже, в том числе с телефона: сессия восстанавливается.

Свой раннер вместо контейнера платформы

Если код должен остаться на вашей машине (сервер, ноутбук, ВМ), запустите в папке проекта zq remote (как установить zq). Такая сессия появится в списке «Код» с пометкой «свой раннер» и хостом; репозиторий подключать не нужно — агент работает с папкой напрямую, а пушит туда, куда настроен ваш git. Всё остальное — лента, разрешения, «Стоп» — как у обычной сессии. Пошагово: Свой раннер (zq remote).

Ограничения

• Раннер гасится кнопкой «Остановить» или после 2 часов без открытой вкладки. Ветка в git остаётся; незапушенные правки — нет, так что просите агента пушить по ходу (он и сам это делает после крупных шагов).
• Одновременно у одного человека — до 3 живых сессий.
• Из контейнера агенту доступны интернет (пакетные реестры, ваш GitLab) и модели платформы; внутренняя сеть платформы — нет.
• Раннер живёт на боевом zubriq.by; на тестовых средах раздел показывает «раннеры выключены».

Модель и стоимость

Агент работает на zubr-coder. На каждую сессию платформа выпускает отдельный ключ (в списке ключей организации он не показывается, живёт неделю и отзывается при остановке) — расход виден в «Настройки → Потребление».