Codex от OpenAI читает AGENTS.md, чтобы понять, как устроен проект. Добавьте короткий раздел «Deploying», и он сможет выложить сайт одной командой, а затем дать вам адрес и ссылку, по которой сайт можно сохранить. Заранее нужно решить только одно: песочницу, ведь деплою нужна сеть.
Как это работает
- Добавьте раздел ниже в AGENTS.md, чтобы Codex знал команду и то, что сказать вам после неё.
- Дайте команде доступ к сети. Codex выполняет команды в песочнице, а деплою нужно связаться с lobsite.com (см. Доступ к сети).
- Попросите Codex задеплоить. Он соберёт проект, выполнит
npx -y lobsite --yesи передаст URL и ссылку для получения. Сайт живёт 6 часов, если вы не откроете ссылку и не войдёте.
Раздел для AGENTS.md
Вставьте это в AGENTS.md проекта. Его используют и другие агенты, читающие этот файл (Cursor, Gemini CLI, Copilot и другие):
## Deploying
This site deploys with [Lobsite](https://lobsite.com). Build it, then from the project folder run:
```bash
npx -y lobsite --yes
```
- Tell the user the URL, and relay the "Tell the user:" line from the output word for word.
- Sites deployed without logging in are removed after 6 hours. The claim link in the output keeps the site; the user opens it and signs in.
- `lobsite.toml` remembers the site, so the same command updates it. Use `--preview` to deploy without changing the live site, and `--json` for machine-readable output.
- If a deploy fails, follow the fix in the error message. Never pass `--include-secrets`.
CLI понимает, что работает под Codex, по переменной CODEX_SANDBOX: не задаёт вопросов и выводит простые строки.
Доступ к сети
Песочница Codex может закрывать командам доступ к сети, и тогда деплой падает с ошибкой соединения, а не с ошибкой Lobsite. Для Codex CLI разрешите сеть командам рабочей области в ~/.codex/config.toml:
[sandbox_workspace_write]
network_access = true
Или подтвердите команду, когда Codex попросит выполнить её вне песочницы. В облачных задачах Codex доступ агента в интернет — настройка окружения; разрешите lobsite.com и upload.lobsite.app (и реестр npm — для npx).
MCP-сервер или curl
Codex CLI может также запустить MCP-сервер Lobsite, который даёт ему инструменты deploy, list_sites, list_deploys, rollback, promote и whoami. Добавьте его в ~/.codex/config.toml:
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Там, где Node не установлен, одну страницу (или несколько файлов) можно задеплоить через curl — в ответ придут URL и ссылка для получения:
curl --data-binary @index.html https://lobsite.com/api/v1/drop
Никаких вопросов при работе агента и строка Tell the user: с URL и ссылкой для получения.
Нет Node? curl --data-binary @index.html lobsite.com/api/v1/drop вернёт URL.
npx lobsite mcp для агентов-программистов, lobsite.com/api/mcp для чат-ассистентов.
Файлы хранятся по хешу. Повторный деплой неизменённого сайта загружает 0 байт.
Предпросмотр до публикации. Откат в один клик — вместе с перенаправлениями.
Все лимиты опубликованы, а каждая ошибка подсказывает, что делать дальше.
Команда, MCP-сервер или curl
npx -y lobsite --yes |
MCP-сервер | curl | |
|---|---|---|---|
| Нужно | Node и сеть | Node и сеть | Только сеть |
| Что загружается | Собранная папка, только изменённые файлы | Собранная папка, только изменённые файлы | Указанные файлы, до 25 МБ |
| Обновляет тот же сайт | Да, lobsite.toml его помнит |
Да | Да, с ?site= и токеном получения |
| Откат, список деплоев | Другими командами | Как инструменты | Нет |
| Настройка | Раздел в AGENTS.md | Запись в config.toml |
Не нужна |
Начните с команды; добавьте MCP-сервер, если хотите, чтобы Codex управлял деплоями, а curl оставьте для песочниц без Node.
Частые вопросы
Почему деплой падает с сетевой ошибкой?
Песочница не пустила команду к lobsite.com. Включите доступ к сети для рабочей области, подтвердите команду вне песочницы или разрешите домены в облачном окружении Codex.
Нужен ли Codex мой аккаунт Lobsite?
Нет. Без аккаунта сайт живёт 6 часов, и Codex даёт вам ссылку для получения. Чтобы деплоить в свой аккаунт, один раз выполните npx lobsite login сами; вход происходит в браузере.
Может ли Codex сначала задеплоить предпросмотр?
Да. npx -y lobsite --yes --preview даёт деплою собственный URL и оставляет рабочий сайт как был. npx lobsite promote <id> публикует его.
А если в проекте есть файл .env?
Секретные файлы никогда не загружаются. Они останавливают деплой с ошибкой, которая объясняет, как их исключить (.lobsiteignore); Codex никогда не должен передавать --include-secrets.
Работает ли это с Codex в IDE?
Да. Расширение запускает того же агента, поэтому читает тот же AGENTS.md, а команда ведёт себя так же.