Перейти к содержимому

ZubrCode с телефона

Приложение ZuBrIQ для Android и iPhone — полноценный клиент ZubrCode в кармане: ставьте задачи агенту, смотрите ленту правок и подтверждайте команды с телефона.

  • Писать агенту, смотреть ленту (чтение файлов, правки диффом, команды) и подтверждать команды оболочки;
  • открывать сессии «Кода» из чата zubriq.ai и сессии своего раннера zubrcode remote (свой раннер);
  • подключаться к своему серверу ZubrCode в локальной сети, через Tailscale, VPN или свой TLS-прокси.

Работать с кодом можно двумя способами:

  1. Сессии «Кода» через аккаунт ZuBrIQ — без настройки сети. Рекомендуется.
  2. Прямое подключение к своему серверу ZubrCode — локальная сеть, Tailscale, VPN, TLS-прокси.

Готовится «ZubrCode Connect» — подключение откуда угодно без туннелей; в приложении уже есть карточка с меткой «Скоро», куда можно записаться в лист ожидания.

Вход — тот же аккаунт zubriq.ai, что и в чате.

Способ 1: сессии «Кода» через аккаунт (рекомендуется)

Заголовок раздела «Способ 1: сессии «Кода» через аккаунт (рекомендуется)»

Никакой настройки сети: ни IP-адресов, ни портов, ни туннелей — сессии приходят в приложение через аккаунт ZuBrIQ.

На вкладке подключений выберите карточку ZuBrIQ и нажмите «Войти через ZuBrIQ» — подтвердите вход в браузере. Под карточкой появится список «Сессии „Кода“». В него попадают:

Тап по сессии открывает её. Раннер можно остановить прямо из приложения — незапушенные правки при этом пропадут. Если раннер остановлен, сессия покажет: «Раннер ещё не готов или остановлен. Откройте сессию в чате, чтобы запустить её снова». Если список пуст: «Сессий пока нет — начните её в чате ZuBrIQ, раздел «Код»».

Приложение подключается напрямую к серверу ZubrCode на вашем компьютере — по локальной сети, Tailscale, VPN или через свой TLS-прокси.

Нужен ZubrCode версии 2.x. Разово, на переднем плане (пароль задаётся переменной OPENCODE_SERVER_PASSWORD):

Окно терминала
OPENCODE_SERVER_PASSWORD='сложный-пароль' zubrcode serve --hostname 0.0.0.0 --port 4096

--hostname 0.0.0.0 — слушать все интерфейсы; без него сервер доступен только с самого компьютера.

Фоновой службой:

Окно терминала
zubrcode service set password 'сложный-пароль'
zubrcode service set hostname 0.0.0.0
zubrcode service set port 4096
zubrcode service start
zubrcode service status

У службы есть также stop, restart, get, unset.

Откройте экран «Подключение к ZubrCode»: укажите «IP-адрес», при желании «Название (необязательно)» и «Пароль (если задан на сервере)», затем нажмите «Подключиться».

Имя пользователя по умолчанию — opencode. Другое имя, полный адрес и другие опции — в «Расширенные настройки (туннели, облако, аутентификация)»:

  • Тип подключения — Локальное / Туннель / Облако;
  • Адрес сервера — полный, с http:// или https://, например http://192.168.1.100:4096;
  • Каталог проекта (необязательно) — пусто означает текущий каталог сервера;
  • Имя пользователя и Пароль;
  • Сохранить подключение.

Перед сохранением приложение проверяет подключение. При ошибке появится «Не удалось подключиться» с адресом и текстом ошибки и кнопкой «Поделиться отчётом».

Подсказки прямо на экране:

  • узнать IP на Mac: ipconfig getifaddr en0;
  • адреса Tailscale: http://100.64.12.34:4096 или http://my-mac.tailnet.ts.net:4096;
  • для локальных адресов и Tailscale используйте http://; https:// — только если настроен TLS;
  • сервер запускается командой zubrcode serve --hostname 0.0.0.0.

В списке подключений тап переключается на подключение, а удержание открывает «Изменить» — там есть «Проверить подключение» и «Удалить подключение». Параметр «Сообщений на странице» позволяет грузить меньше сообщений за раз — страница открывается быстрее.

  • Никогда не открывайте порт сервера ZubrCode в интернет без пароля.
  • Из-за пределов домашней сети подключайтесь только через Tailscale/VPN или свой TLS-прокси.
  • Хотите работать «откуда угодно» без туннелей — используйте способ 1 с zubrcode remote.
  • Сервер запущен с --hostname 0.0.0.0 (иначе он слушает только локально)?
  • Телефон в той же сети или в том же tailnet, что и компьютер?
  • Порт указан верно и схема подходящая: http:// для локальных адресов и Tailscale, https:// — только с настроенным TLS?
  • Пароль введён, имя пользователя — opencode (если на сервере не задано другое)?
  • Файрвол компьютера не блокирует порт?
  • Не помогло — нажмите «Поделиться отчётом» на экране ошибки и пришлите отчёт.

Приложение обновляется через магазин приложений. Удаление стирает только настройки и подключения на телефоне — сессии и данные на сервере и в аккаунте ZuBrIQ остаются.