Codex Relay CLI
Codex Relay дает следить за сессиями Codex CLI и отвечать агенту с телефона, пока работа остается на компьютере.
- 739 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Телефон получает управление локальной сессией Codex, включая подтверждения действий.
Установка
- Работает в
Ручная установка
npx codex-relay@latestИз раздела Quick Start. Запуск печатает QR-код и ссылку сопряжения, мобильное приложение ставится из App Store.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Телефон получает управление локальной сессией Codex, включая подтверждения действий.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Codex Relay — мобильный спутник для Codex CLI. Команда `npx codex-relay@latest` запускает локальный релей в рабочей папке и печатает QR-код и ссылку `codex-relay://pair...`. Приложение на телефоне сканирует код, а подтверждение выдается на компьютере командой `approve`. После сопряжения доступны поток вывода Codex, отправка запросов, продолжение веток, ответы на вопросы агента, очередь ввода и согласования, предпросмотр git-изменений, локального веб-вывода и файлов. Пуш-уведомления настраиваются отдельно для завершенного хода и для действия, которого ждет агент.
Для кого. Разработчикам на Codex CLI, которые запускают долгие задачи и хотят подтверждать действия агента, не сидя за компьютером.
Подходит, если
- Codex ждет подтверждения, а вы вышли из комнаты.
- Долгая задача идет на рабочей машине, и нужно видеть, чем закончился ход.
- С телефона нужно продолжить ветку и посмотреть git-изменения.
- Предпросмотр локального веб-приложения нужен прямо на мобильном.
Не подходит, если
- Нет устройства iOS, приложение распространяется через App Store.
- Сеть не дает телефону доступа к компьютеру.
- Нужна работа с Claude Code или другим агентом, а не с Codex.
Пример запроса к агенту
Запусти релей в этой папке, покажи QR-код для сопряжения и объясни, как подтвердить телефон.Ограничения
Нужны Node.js 22.14 или новее, установленный и авторизованный Codex CLI и сетевой путь от телефона к компьютеру. Для разных сетей README советует Tailscale. Проект независимый и не связан с OpenAI. Через релей телефон управляет локальной сессией Codex, подтверждайте только свои устройства. В разделе Quick Start упомянут только магазин App Store. Релей работает, пока запущен в терминале. Сопряжение подтверждается на компьютере командой `approve`, без нее телефон к сессии не подключится.
Как отключить. Остановите релей в терминале и удалите приложение с телефона. Данные сопряжения лежат в локальном состоянии релея, очистите их отдельно.
Частые вопросы
Как сопрячь телефон?
Запустите релей, отсканируйте QR-код в приложении и подтвердите показанный код командой `npx codex-relay@latest approve XXXX-XXXX`.
Можно ли использовать одну сессию с терминалом?
Да. Запуск с флагом `--shared-app-server` объединяет мобильное приложение и терминальный интерфейс в одном процессе.
Что делать, если телефон в другой сети?
Рекомендован Tailscale, а для предпросмотра веб-приложения лучше Tailscale Serve.
Где остается код?
На компьютере: код, оболочка, состояние git и сессия Codex не покидают его, телефон говорит с вашим релеем.
Какие уведомления есть?
В настройках приложения отдельно включаются уведомления о завершении хода и о действии, которого ждет агент.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПульт для Codex и Claude Code с iPhone и iPad: смотрите ход работы, отвечайте и подтверждайте действия агента на компьютере.
Локальная доска задач с CLI taskctl и скиллом для Codex, Claude Code и других агентов: заводит issue, двигает статусы и хранит комментарии по правилам
CLI для macOS и Linux: сессии Codex, Claude Code и Grok с компьютера открываются на телефоне по QR-коду, шифрование сквозное
Несколько копий настольного Codex рядом: у каждого аккаунта свой значок, вход, чаты и плагины, переключаться не нужно.
CLI передает контекст сеанса между кодовыми агентами: сессию Claude Code можно продолжить в Codex, Cursor, OpenCode и других.
Утилита возвращает в Codex пропавшие после смены провайдера диалоги: синхронизирует сессии и SQLite, делает резервные копии.
Коротко о README
Релей живет в рабочей папке, QR-сопряжение и пуш-уведомления настраиваются из приложения. Принцип проекта — локальная работа.