Работа в Promto
Codex в терминале
Нативный Codex CLI для разработки, команд, тестов и системной работы с репозиторием.
Codex в терминале
Codex — нативный coding agent OpenAI, запущенный прямо в PTY рабочего стола Promto. Он читает и изменяет файлы, выполняет shell-команды, запускает тесты и работает с репозиторием через собственный интерфейс Codex CLI.
Зачем использовать Codex
Codex подходит для инженерных задач, где нужен нативный workflow coding agent:
- изучить большой репозиторий и найти связанные участки кода;
- реализовать функцию в нескольких файлах;
- локализовать и исправить ошибку;
- провести рефакторинг с тестами;
- обновить зависимости или конфигурацию сборки;
- запустить тесты, линтер, typecheck и build;
- работать итеративно: изменить код, увидеть вывод, уточнить задачу и продолжить в той же сессии.
Главное преимущество здесь не в «магически более умном ответе», а в прямом доступе к нативному Codex CLI: его собственным командам, модели, reasoning, управлению контекстом и сессией.
Чем Codex отличается от основного агента Promto
Основной агент встроен в продукт: он отвечает сообщениями, использует trusted tools Promto и может создавать интерфейсные действия для Preview, Android, Design, File или Publish.
Codex в терминале:
- показывает нативный TUI Codex;
- самостоятельно управляет своим контекстом, моделью и reasoning;
- использует собственные file/shell tools;
- работает как долгоживущий процесс в PTY;
- получает платформенные возможности через команды
promto; - не превращает терминальный вывод в обычную историю чата;
- не создаёт кнопки из строк
Preview:,OpenFile:или других UI-маркеров.
Оба варианта работают с одними файлами. Поэтому удобно, например, обсудить архитектуру с основным агентом, выполнить реализацию в Codex, а результат открыть в VS Code или Preview.
Что происходит при запуске
- Вы выбираете Codex на стартовом экране терминала.
- Promto проверяет поддерживаемую версию CLI и при необходимости устанавливает её.
- Для этой терминальной вкладки создаётся отдельное состояние Codex.
- Promto автоматически подключает сессию к модельному API рабочего стола; отдельный вход обычно не нужен.
- Открывается нативный интерактивный Codex.
Модель, reasoning и команды сессии принадлежат Codex CLI. Promto не подменяет их собственным селектором терминала.
Какие возможности становятся доступны
Прямой цикл разработки
Codex может в одной сессии:
- прочитать инструкции и структуру проекта;
- найти реализацию через
rg; - внести узкие изменения;
- запустить тест или сборку;
- проверить Preview;
- изучить ошибку и повторить цикл.
Вы видите фактический вывод каждой команды и можете вмешаться, уточнить ограничение или остановить процесс.
Полный доступ к среде проекта
Codex работает как root внутри рабочего стола. Он может устанавливать системные и проектные зависимости через apt-get, npm, pnpm, yarn, pip или uv, менять конфигурацию и запускать процессы или dev-серверы без sudo. Системные сервисы через systemd, snapd и snap в этой среде не запускаются.
Для операций самой платформы он использует promto: управление Preview-портами, снимок приложения, общий браузер, загрузку media-ассетов в CDN с получением URL, диск, Android и публикацию.
Долгоживущая вкладка
Переключение на другую вкладку или обычная перезагрузка страницы не останавливает живой PTY. Codex может продолжать тест, установку или другую команду. Если рабочий стол был фактически перезапущен, Promto повторно запускает CLI, но не следует считать это гарантией восстановления каждого внутреннего шага прежнего диалога.
Telegram
У Codex CLI нет нативного Telegram channel, поэтому Promto запускает рядом с ним совместимый адаптер. Каждый разрешённый Telegram-диалог получает отдельную сохраняемую Codex thread, а модельные вызовы выполняются через тот же управляемый proxy и нейробаланс.
Настройка выполняется один раз внутри Codex:
!promto-codex-telegram configure <bot-token>Перезапустите Codex и напишите боту. Он вернёт шестизначный код:
!promto-codex-telegram pair <code>После pairing бот переходит в allowlist. Команда /new в Telegram начинает новую Codex thread, /status показывает состояние канала. Локальная команда !promto-codex-telegram status показывает настройки без bot token.
Полная пошаговая инструкция по Telegram для всех CLI-агентов также объясняет создание бота, жизненный цикл канала и безопасную диагностику.
Когда выбирать Codex
Codex — хороший выбор, когда:
- задача в первую очередь связана с кодом и репозиторием;
- нужны точные правки, тесты и проверяемый результат;
- вы предпочитаете нативный Codex CLI;
- важно видеть команды и их полный вывод;
- работа займёт несколько итераций в одной сессии.
Основной агент удобнее, когда нужна простая постановка задачи, продуктовые кнопки Promto и история обсуждения.
Hermes Agent стоит попробовать, если вы хотите другой автономный TUI и нативный выбор моделей через его экосистему.
OpenClaw уместен, когда важен именно OpenClaw workflow с локальным Gateway, TUI и его собственной конфигурацией.
Как ставить задачу Codex
Хороший первый запрос содержит:
- точный результат;
- границы: что менять и чего не трогать;
- существующий контекст и известные симптомы;
- критерии готовности;
- обязательную проверку;
- явное разрешение или запрет на публикацию.
Пример структуры:
Контекст: <что за проект и где проблема>.
Результат: <что должно работать>.
Ограничения: <что сохранить, не менять и не публиковать>.
Проверка: <конкретный тест, build или пользовательский сценарий>.Для большой задачи сначала попросите Codex составить короткий план по фактическим файлам. Для небольшого исправления лучше сразу попросить найти причину, сделать минимальную правку и повторить точный сценарий.
Инструкции и CLI для агента
Codex сохраняет собственные system prompt и native tools. Promto добавляет к ним контракт Promto terminal agent. Он автоматически передаётся как developer_instructions и также доступен через проектный AGENTS.md.
В начале работы Codex может явно вывести общий контракт:
promto instructionsПолезные команды Promto:
promto help
promto port owner <порт>
promto port free <начальный-порт>
promto preview screenshot --current --port <порт>
promto browser status
promto asset upload <файл> --json
promto disk
promto disk top /home/user 20Перед публикацией или мобильной задачей:
promto publish get-instruction
promto mobile instructionsНативные codex --help и codex --version предназначены для диагностики CLI из обычного shell. Не просите уже запущенный Codex запускать вложенную копию самого себя без причины.
Встроенные get_instruction({ topic: "runtime" }), promto_preview и другие trusted tools основного агента нельзя вводить в shell. Их терминальные эквиваленты — promto instructions, promto preview и остальные подкоманды promto.
Готовый промпт для Codex
Сначала выведи и учти promto instructions, прочитай все применимые AGENTS.md и проверь git status. Через rg найди текущую реализацию и реальные команды проекта. Задача: <опишите результат>. Сохрани мои существующие изменения и не делай unrelated-правок. Перед dev-сервером проверь порт через promto port, после UI-изменений сделай проверку через promto preview screenshot --current --port <порт>. Запусти релевантные тесты, typecheck или build. Не публикуй. В финале укажи изменённые файлы, выполненные команды и непроверенные части.Практический рабочий процесс
- Создайте отдельную терминальную вкладку и выберите Codex.
- Дождитесь нативного prompt.
- Отправьте задачу с границами и критериями готовности.
- Следите за запросами Codex и фактическим выводом команд.
- Если вы переключили приложение, используйте Прикрепить контекст и проверьте вставленный текст перед отправкой.
- Откройте изменённые файлы в VS Code или Файлах.
- Проверьте приложение во вкладке Preview.
- Только после проверки отдельно разрешайте commit, push или публикацию.
Частые ошибки
Начать с команды без описания результата. Codex лучше выбирает действия, когда понимает не только команду, но и критерий готовности.
Попросить «исправить всё». Укажите воспроизводимый сценарий, ожидаемое поведение и область проекта.
Считать build полноценной визуальной проверкой. Для интерфейса нужен запущенный проект и promto preview screenshot --current --port <порт>.
Закрыть вкладку во время долгой операции. Закрытие терминальной вкладки завершает PTY. Для обычного переключения просто откройте другую вкладку — Codex продолжит работать.