Codex від OpenAI читає AGENTS.md, щоб зрозуміти роботу проєкту. Додайте короткий розділ про розгортання — і він зможе опублікувати сайт однією командою, а потім передати адресу та посилання для збереження. Спершу потрібно владнати лише доступ із пісочниці: розгортанню потрібна мережа.
Як це працює
- Додайте наведений нижче розділ до 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, а команда поводиться так само.