ZubrCode с телефона
Приложение ZuBrIQ для Android и iPhone — полноценный клиент ZubrCode в кармане: ставьте задачи агенту, смотрите ленту правок и подтверждайте команды с телефона.
Что можно делать с телефона
Заголовок раздела «Что можно делать с телефона»- Писать агенту, смотреть ленту (чтение файлов, правки диффом, команды) и подтверждать команды оболочки;
- открывать сессии «Кода» из чата zubriq.ai и сессии своего раннера
zubrcode remote(свой раннер); - подключаться к своему серверу ZubrCode в локальной сети, через Tailscale, VPN или свой TLS-прокси.
Работать с кодом можно двумя способами:
- Сессии «Кода» через аккаунт ZuBrIQ — без настройки сети. Рекомендуется.
- Прямое подключение к своему серверу ZubrCode — локальная сеть, Tailscale, VPN, TLS-прокси.
Готовится «ZubrCode Connect» — подключение откуда угодно без туннелей; в приложении уже есть карточка с меткой «Скоро», куда можно записаться в лист ожидания.
Установить приложение
Заголовок раздела «Установить приложение»- Android — Google Play: by.zubriq.code;
- iPhone — бета через TestFlight, ссылка — на странице «Приложения».
Вход — тот же аккаунт zubriq.ai, что и в чате.
Способ 1: сессии «Кода» через аккаунт (рекомендуется)
Заголовок раздела «Способ 1: сессии «Кода» через аккаунт (рекомендуется)»Никакой настройки сети: ни IP-адресов, ни портов, ни туннелей — сессии приходят в приложение через аккаунт ZuBrIQ.
На вкладке подключений выберите карточку ZuBrIQ и нажмите «Войти через ZuBrIQ» — подтвердите вход в браузере. Под карточкой появится список «Сессии „Кода“». В него попадают:
- сессии из чата zubriq.ai, раздел «Код» (как устроены сессии в чате);
- сессии своего раннера
zubrcode remote(свой раннер) — машина может быть за NAT, входящие порты не нужны.
Тап по сессии открывает её. Раннер можно остановить прямо из приложения — незапушенные правки при этом пропадут. Если раннер остановлен, сессия покажет: «Раннер ещё не готов или остановлен. Откройте сессию в чате, чтобы запустить её снова». Если список пуст: «Сессий пока нет — начните её в чате ZuBrIQ, раздел «Код»».
Способ 2: свой сервер ZubrCode
Заголовок раздела «Способ 2: свой сервер ZubrCode»Приложение подключается напрямую к серверу 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.0zubrcode service set port 4096zubrcode service startzubrcode 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 остаются.