Codex Remote

Codex Remote позволяет запускать и контролировать сессии Codex CLI на вашем компьютере с телефона, планшета или любого браузера.

Интерфейс показывает поток ответов в реальном времени, подтверждения действий и изменения файлов до применения.

Что Внутри

Архитектура состоит из трёх частей. Anchor работает локально и подключается к вашему codex app-server. Orbit работает в облаке и даёт аутентификацию, WebSocket relay и API. Web client открывается в браузере и управляет сессиями.

Браузер
  │ HTTPS + WebSocket
  ▼
Orbit (Cloudflare или Deno Deploy)
  │ WebSocket
  ▼
Anchor (локально)
  │ JSON-RPC over stdio
  ▼
codex app-server

Что Нового

В проект добавлен второй self-host провайдер deno, а также единый флоу codex-remote self-host --provider ... --login, который сразу после деплоя выполняет вход устройства без отдельного ручного шага.

Быстрый Старт

Установка на macOS или Linux

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

Установка на Windows в режиме release или source

$env:CODEX_REMOTE_INSTALL_MODE="release"
iwr -useb https://raw.githubusercontent.com/dwnmf/codex_remote/main/install.ps1 | iex

$env:CODEX_REMOTE_INSTALL_MODE="source"
iwr -useb https://raw.githubusercontent.com/dwnmf/codex_remote/main/install.ps1 | iex

Запуск self-host через Cloudflare

codex-remote self-host --provider cloudflare --login
codex-remote start

Запуск self-host через Deno Deploy

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

Для Deno нужен DENO_DEPLOY_TOKEN. Токен можно создать в кабинете Deno Deploy: https://dash.deno.com/account#access-tokens. Текущий deployctl работает с Classic-организациями Deno Deploy.

Запуск мастера self-host прямо во время install

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

Команды CLI

Схема Self-Host Флоу

codex-remote self-host --provider deno --login
        │
        ├─ Проверка локального окружения
        ├─ Проверка провайдерных инструментов
        ├─ Генерация JWT и VAPID секретов
        ├─ Деплой Orbit backend
        ├─ Сборка и деплой web
        ├─ Запись .env для Anchor
        └─ codex-remote login

Deno Провайдер: Аутентификация

На Deno-провайдере поддерживаются оба варианта входа в web: passkey и TOTP.

Если Сессии Не Грузятся

Сначала проверьте состояние одной командой.

codex-remote doctor

Если в doctor всё OK, обычно помогает перезапуск Anchor.

codex-remote start

В self-host режиме URL в настройках должен вести на ваш Orbit endpoint и заканчиваться на /ws/client, например wss://<your-app>.deno.dev/ws/client.

Локальная Разработка

bun run lint
bun run test
bun run ci:local

bun run dev:all

По умолчанию frontend открывается на http://localhost:5173, backend на http://localhost:8080.

Документация

Лицензия

MIT