Codex, de OpenAI, lee AGENTS.md para saber cómo funciona un proyecto. Dale una sección corta de «Deploying» y podrá publicar el sitio con un comando y luego darte la dirección y un enlace para conservarlo. Solo hay que resolver una cosa antes: el sandbox, porque un deploy necesita la red.
Cómo funciona
- Añade la sección de abajo a AGENTS.md, para que Codex conozca el comando y qué decirte después.
- Deja que el comando llegue a la red. Codex ejecuta los comandos en un sandbox, y el deploy tiene que hablar con lobsite.com (consulta Acceso a la red).
- Pide a Codex que despliegue. Compila, ejecuta
npx -y lobsite --yesy te transmite la URL y el enlace para reclamarlo. El sitio dura 6 horas a menos que abras el enlace e inicies sesión.
La sección de AGENTS.md
Pega esto en el AGENTS.md del proyecto. Otros agentes que leen el archivo (Cursor, Gemini CLI, Copilot y más) también la usan:
## 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`.
La CLI sabe que se ejecuta bajo Codex por la variable CODEX_SANDBOX: no hace preguntas e imprime líneas simples.
Acceso a la red
El sandbox de Codex puede bloquear el acceso a la red de los comandos, y entonces el deploy falla con un error de conexión en lugar de un error de Lobsite. En la Codex CLI, permite la red para los comandos del espacio de trabajo en ~/.codex/config.toml:
[sandbox_workspace_write]
network_access = true
O aprueba el comando cuando Codex pida ejecutarlo fuera del sandbox. En las tareas de Codex en la nube, el acceso a internet del agente es un ajuste del entorno; permite lobsite.com y upload.lobsite.app (y el registro de npm, para npx).
El servidor MCP, o curl
La Codex CLI también puede iniciar el servidor MCP de Lobsite, que le da deploy, list_sites, list_deploys, rollback, promote y whoami como herramientas. Añádelo a ~/.codex/config.toml:
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Donde no hay Node instalado, una página (o unos pocos archivos) se despliega con curl, que responde con la URL y el enlace para reclamarla:
curl --data-binary @index.html https://lobsite.com/api/v1/drop
Sin preguntas bajo un agente, y una línea Tell the user: con la URL y el enlace para reclamarlo.
¿Sin Node? curl --data-binary @index.html lobsite.com/api/v1/drop responde con la URL.
npx lobsite mcp para agentes de programación, lobsite.com/api/mcp para asistentes de chat.
Los archivos se guardan por su hash. Volver a desplegar un sitio sin cambios sube 0 bytes.
Previsualiza antes de publicar. Vuelve atrás con un clic, redirecciones incluidas.
Todos los límites están publicados y cada error te dice qué hacer a continuación.
Comando, servidor MCP o curl
npx -y lobsite --yes |
Servidor MCP | curl | |
|---|---|---|---|
| Necesita | Node y red | Node y red | Solo red |
| Qué sube | La carpeta compilada, solo los archivos cambiados | La carpeta compilada, solo los archivos cambiados | Los archivos que indiques, hasta 25 MB |
| Actualiza el mismo sitio | Sí, lobsite.toml lo recuerda |
Sí | Sí, con ?site= y el token para reclamarlo |
| Revertir, listar deploys | Con más comandos | Como herramientas | No |
| Configuración | Sección en AGENTS.md | Entrada en config.toml |
Ninguna |
Empieza con el comando; añade el servidor MCP si quieres que Codex gestione los deploys, y deja curl para los sandbox sin Node.
Preguntas frecuentes
¿Por qué falla el deploy con un error de red?
El sandbox impidió que el comando llegara a lobsite.com. Activa el acceso a la red para el espacio de trabajo, aprueba el comando fuera del sandbox o permite los dominios en tu entorno de Codex en la nube.
¿Necesita Codex mi cuenta de Lobsite?
No. Sin cuenta el sitio dura 6 horas y Codex te da el enlace para reclamarlo. Para desplegar en tu cuenta, ejecuta tú una vez npx lobsite login; el inicio de sesión ocurre en un navegador.
¿Puede Codex desplegar primero una vista previa?
Sí. npx -y lobsite --yes --preview da al deploy su propia URL y deja el sitio publicado como estaba. npx lobsite promote <id> lo publica.
¿Y si mi proyecto tiene un archivo .env?
Los archivos secretos nunca se suben. Detienen el deploy con un error que explica cómo dejarlos fuera (.lobsiteignore); Codex nunca debe pasar --include-secrets.
¿Funciona con Codex en el IDE?
Sí. La extensión ejecuta el mismo agente, así que lee el mismo AGENTS.md, y el comando se comporta igual.