Codex с телефона, пока ты не за компьютером (даже с контролем git изменений)

Бывает так: ушёл на тренировку, сел в кафе, поехал куда-то. В голове крутится задача, которую хочется уже добить. Раньше приходилось ждать, пока вернёшься за стол. Теперь нет.

Codex Remote даёт браузерный интерфейс к Codex CLI на вашей машине. Открываешь с телефона, управляешь сессией, видишь изменения файлов до того, как они применились. Машина работает у тебя дома или на работе, ты где угодно.

Есть также возможность просматривать незакомиченные изменения в git'е в самом диалоге с моделью.

Как это работает

У Codex CLI есть очевидная проблема: он живёт в терминале на конкретной машине. Хочешь что-то запустить - садись за компьютер. Отошёл от стола - ждёшь.

Codex Remote решает это через прокси-архитектуру. Локальный агент (Anchor) подключается к вашему codex app-server через JSON-RPC по stdio. Облачный relay (Orbit) соединяет браузер с этим агентом через WebSocket.

Никакого туннелирования, никакого проброса портов. Orbit не видит ваши файлы, только поток сообщений.

Деплой

Orbit вы разворачиваете сами, ваши данные не уходят на чужой сервер. Поддерживаются Cloudflare Workers и Deno Deploy, оба влезают в бесплатный тир. Но если вы в России и без VPN, Cloudflare скорее всего не заработает. Deno Deploy в этом плане стабильнее.

codex-remote self-host --provider deno --login

Одна команда запускает мастер: проверяет окружение, генерирует JWT и VAPID секреты, деплоит Orbit backend, собирает и деплоит веб-клиент, записывает .env для Anchor. Потом сразу логинит устройство, без отдельного ручного шага.

Для Deno нужен токен из dash.deno.com. Если что-то пошло не так, мастер объяснит что именно.

Честное предупреждение про установку: скрипты работают не всегда с первого раза. Могут споткнуться о нестандартные пути или права доступа. Если что-то пойдёт не так, придётся немного поработать руками.

Установка на Linux(MacOS не тестировал):

curl -fsSL https://raw.githubusercontent.com/dwnmf/codex_remote/main/install.sh | bash

Windows:

iwr -useb https://raw.githubusercontent.com/dwnmf/codex_remote/main/install.ps1 | iex

Установка и деплой одной командой:

CODEX_REMOTE_RUN_SELF_HOST=1 curl -fsSL https://raw.githubusercontent.com/dwnmf/codex_remote/main/install.sh | bash

Когда что-то ломается

codex-remote doctor проверяет окружение, .env, токены и статус Anchor. Большинство проблем решается после неё.

Если doctor говорит OK, но сессии не грузятся, попробуй codex-remote start. Обычно хватает.

В self-host режиме URL должен заканчиваться на /ws/client:

wss://<your-app>.deno.dev/ws/client

Стек: Bun, TypeScript, Cloudflare Workers / Deno Deploy. Репозиторий:

github.com/dwnmf/codex_remote

Работы хватает: скрипты установки стабильно ломаются в нестандартных окружениях. Если пользуетесь инструментом и что-то раздражает, PR лучший способ это исправить.

Буду рад звездам и контрибуциям :)

Если вы уже используете Codex CLI и хочется не сидеть ради него за столом, это работает.