Работа через Codex

Плагин FlutterFlow для Codex позволяет создавать и править проекты, описывая нужный результат словами. Он проводит Codex через авторизацию, разворачивание рабочего пространства, разбор проекта, правку с учётом веток, проверку и выгрузку кода.

Репозиторий плагина: FlutterFlow/flutterflow-codex.

Плагин опирается на FlutterFlow CLI и на сервер MCP, привязанный к рабочему пространству. Источником истины остаётся сам проект FlutterFlow — результат открывается в визуальном редакторе, где работу можно продолжить.

Общее устройство и полный список команд — в разделе про работу с ИИ-агентами.

Терминал или приложение

Плагин работает и в Codex CLI, и в Codex внутри приложения ChatGPT. После установки схема работы одинакова, но установка, требования и запуск задач различаются — читайте только свой раздел.

Плагин распространяется из репозитория FlutterFlow Codex, где лежит маркетплейс с единственным плагином. В Codex CLI маркетплейс добавляется командой, в приложении ChatGPT — через раздел Plugins в боковом меню.

Codex CLI

Что нужно

• Установленный Codex CLI.
• Dart и Flutter в PATH.
• Токен API со страницы аккаунта FlutterFlow — понадобится, когда плагин попросит авторизоваться.

Установите или обновите FlutterFlow CLI:

dart pub global activate flutterflow_cli

Установка

1. Добавьте маркетплейс и поставьте плагин:

codex plugin marketplace add https://github.com/FlutterFlow/flutterflow-codex --ref main
codex plugin add flutterflow@flutterflow

2. Начните новый сеанс Codex CLI из рабочей папки:

cd /path/to/your/projects
codex

3. Введите /plugins и убедитесь, что flutterflow@flutterflow установлен и включён.

4. Закройте список плагинов и опишите задачу.

Если Codex CLI был запущен во время установки или обновления плагина, выйдите и запустите его заново — иначе навык FlutterFlow не загрузится.

Приложение ChatGPT

Что нужно

Установленное и запущенное приложение ChatGPT. Ни Codex CLI, ни команды в терминале для добавления маркетплейса не требуются.

Плагин можно поставить до настройки инструментов и авторизации: при первой задаче он проверит Dart, Flutter и FlutterFlow CLI и поможет доустановить недостающее. Токен API он спросит только тогда, когда действительно понадобится.

Установка

1. Выберите Plugins в боковом меню Codex.

2. На странице Plugins откройте меню Create и выберите Add marketplace.

3. Введите адрес маркетплейса:

https://github.com/FlutterFlow/flutterflow-codex

4. Завершите добавление маркетплейса и откройте страницу плагина FlutterFlow.

5. Нажмите кнопку с плюсом, чтобы установить его.

6. Начните новую задачу Codex — тогда загрузится навык FlutterFlow.

7. Выберите папку, в которой Codex создаст новое рабочее пространство FlutterFlow, либо укажите существующее, если продолжаете работу над проектом.

8. Опишите задачу.

Подробнее об установке плагинов — в документации OpenAI.

Безопасная авторизация

Порядок одинаков в Codex CLI и в приложении ChatGPT, и вставлять токен в задачу не нужно.

Когда потребуется авторизация, Codex попросит:

1. Открыть страницу аккаунта FlutterFlow и скопировать токен.
2. Вернуться в Codex и написать только copied.

Дальше плагин один раз прочитает буфер обмена, проверит формат, сохранит токен в закрытый файл настроек с ограниченными правами и очистит буфер, нигде его не показав.

Создание приложения

Начните задачу из папки, где должно появиться рабочее пространство, и опишите приложение. Например:

Create a new FlutterFlow app called habit_tracker. Make it a minimalist habit tracker with daily check-ins, streaks, and a weekly progress view.

Codex:

1. Проверит авторизацию FlutterFlow.
2. Развернёт рабочее пространство подходящей версии.
3. Прочитает его инструкции и типизированный SDK проекта.
4. Спланирует и проверит приложение, прежде чем создавать проект на сервере.
5. Вернёт ссылку на проект во FlutterFlow.

После успешного создания правьте проект следующими запросами в том же рабочем пространстве, а не создавайте его заново.

Правка проекта

Если идентификатор проекта известен, укажите его в запросе:

Edit my FlutterFlow project <project-id>. Add a settings page with profile, notification, and privacy sections.

Идентификатор виден в адресе проекта в редакторе:

https://app.flutterflow.io/project/<project-id>

Если идентификатора нет под рукой, попросите Codex показать список — у CLI есть интерактивный выбор проекта с поиском:

List my FlutterFlow projects so I can choose which one to edit.

Codex создаст или переиспользует рабочее пространство, привязанное к проекту. Перед внесением изменений он проверит активную ветку, разберёт текущее состояние проекта и прогонит проверки рабочего пространства.

Выгрузка кода

Укажите проект и папку назначения:

Export my FlutterFlow project <project-id> to Flutter code in ./generated_app.

Выгрузка идёт обычным механизмом FlutterFlow CLI, а не через сценарий правки проекта. Параметры, выбор ветки и работа .flutterflowignore описаны в разделе про выгрузку проекта.

Что плагин проверяет перед правкой

• Работа идёт внутри развёрнутого рабочего пространства с файлом .flutterflow/config.yaml.
• Инструкции AGENTS.md соответствующей версии прочитаны до написания изменений.
• Активная ветка FlutterFlow и её идентификатор проекта подтверждены.
• Текущее состояние проекта разобрано, имена берутся из типизированного SDK, а не угадываются.
• Перед применением выполняется flutterflow ai test.
• Изменения применяются с явным сообщением коммита.
• После операции проверяются история, трассировка и контекст проекта.

Неудачная проверка изменение не отправляет. Сбой на более поздних стадиях — создание, сеть, конфликт, отправка, действия после отправки — может иметь последствия на сервере, поэтому Codex сначала смотрит на результат и только потом повторяет операцию.

FlutterFlow MCP в Codex

Сервер MCP привязан к проекту. При развёртывании рабочего пространства CLI может записать настройки Codex в .codex/config.toml — для сервера FlutterFlow MCP этого пространства.

После записи настроек начните новую задачу Codex из этой папки, чтобы инструменты загрузились. Если инструменты MCP недоступны, плагин продолжит работу через FlutterFlow CLI.

Обновление плагина

В Codex CLI

codex plugin marketplace upgrade flutterflow
codex plugin add flutterflow@flutterflow

Выйдите из Codex CLI, запустите заново и начните новую задачу: открытые сеансы обновлённый плагин не подхватывают.

В приложении ChatGPT

Откройте Plugins и обновите плагин оттуда, затем начните новую задачу — уже открытые задачи обновление не подхватят.

FlutterFlow CLI обновляется отдельно:

dart pub global activate flutterflow_cli

Решение проблем

https://github.com/FlutterFlow/flutterflow-codex

dart pub global activate flutterflow_cli

.flutterflow/config.yaml

Поддержка

• Исходный код и заметки о выпусках.
• Сообщения об ошибках.
• Команда flutterflow ai docs [topic] внутри рабочего пространства открывает справку нужной версии.