Codex, d’OpenAI, lit AGENTS.md pour apprendre comment fonctionne un projet. Donnez-lui une courte section « Deploying » et il peut mettre le site en ligne en une commande, puis vous donner l’adresse et un lien qui permet de garder le site. Une seule chose à régler d’abord : le bac à sable, car un déploiement a besoin du réseau.
Comment ça marche
- Ajoutez la section ci-dessous à AGENTS.md, pour que Codex connaisse la commande et sache quoi vous dire ensuite.
- Laissez la commande accéder au réseau. Codex exécute les commandes dans un bac à sable, et le déploiement doit joindre lobsite.com (voir Accès réseau).
- Demandez à Codex de déployer. Il builde, lance
npx -y lobsite --yeset relaie l’URL et le lien de récupération. Le site dure 6 heures, sauf si vous ouvrez le lien et vous connectez.
La section pour AGENTS.md
Collez ceci dans le AGENTS.md du projet. Les autres agents qui lisent ce fichier (Cursor, Gemini CLI, Copilot et d’autres) s’en servent aussi :
## 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 sait qu’elle tourne sous Codex grâce à la variable CODEX_SANDBOX : elle ne pose aucune question et affiche des lignes simples.
Accès réseau
Le bac à sable de Codex peut bloquer l’accès réseau des commandes, et le déploiement échoue alors avec une erreur de connexion plutôt qu’une erreur Lobsite. Pour la Codex CLI, autorisez le réseau pour les commandes de l’espace de travail dans ~/.codex/config.toml :
[sandbox_workspace_write]
network_access = true
Ou approuvez la commande quand Codex demande à l’exécuter hors du bac à sable. Dans les tâches Codex dans le cloud, l’accès internet de l’agent est un réglage de l’environnement ; autorisez lobsite.com et upload.lobsite.app (et le registre npm, pour npx).
Le serveur MCP, ou curl
La Codex CLI peut aussi démarrer le serveur MCP de Lobsite, qui lui donne deploy, list_sites, list_deploys, rollback, promote et whoami comme outils. Ajoutez-le à ~/.codex/config.toml :
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Là où Node n’est pas installé, une page (ou quelques fichiers) se déploie avec curl, qui répond avec l’URL et le lien de récupération :
curl --data-binary @index.html https://lobsite.com/api/v1/drop
Aucune question posée sous un agent, et une ligne Tell the user: avec l’URL et le lien de récupération.
Pas de Node ? curl --data-binary @index.html lobsite.com/api/v1/drop répond avec l’URL.
npx lobsite mcp pour les agents de code, lobsite.com/api/mcp pour les assistants de chat.
Les fichiers sont stockés selon leur hash. Redéployer un site inchangé envoie 0 octet.
Prévisualisez avant la mise en ligne. Revenez en arrière en un clic, redirections comprises.
Chaque limite est publiée, et chaque erreur vous dit quoi faire ensuite.
Commande, serveur MCP ou curl
npx -y lobsite --yes |
Serveur MCP | curl | |
|---|---|---|---|
| Demande | Node et le réseau | Node et le réseau | Le réseau seulement |
| Ce qui est envoyé | Le dossier buildé, seulement les fichiers modifiés | Le dossier buildé, seulement les fichiers modifiés | Les fichiers que vous indiquez, jusqu’à 25 Mo |
| Met à jour le même site | Oui, lobsite.toml le mémorise |
Oui | Oui, avec ?site= et le jeton de récupération |
| Retour arrière, liste des déploiements | Avec d’autres commandes | En tant qu’outils | Non |
| Mise en place | Section dans AGENTS.md | Entrée dans config.toml |
Aucune |
Commencez par la commande ; ajoutez le serveur MCP si vous voulez que Codex gère les déploiements, et gardez curl pour les bacs à sable sans Node.
Questions fréquentes
Pourquoi le déploiement échoue-t-il avec une erreur réseau ?
Le bac à sable a empêché la commande de joindre lobsite.com. Activez l’accès réseau pour l’espace de travail, approuvez la commande hors du bac à sable, ou autorisez les domaines dans votre environnement Codex dans le cloud.
Codex a-t-il besoin de mon compte Lobsite ?
Non. Sans compte, le site dure 6 heures et Codex vous donne le lien de récupération. Pour déployer dans votre compte, lancez vous-même une fois npx lobsite login ; la connexion se fait dans un navigateur.
Codex peut-il d’abord déployer un aperçu ?
Oui. npx -y lobsite --yes --preview donne au déploiement sa propre URL et laisse le site en ligne tel quel. npx lobsite promote <id> le met en ligne.
Et si mon projet contient un fichier .env ?
Les fichiers secrets ne sont jamais envoyés. Ils arrêtent le déploiement avec une erreur qui explique comment les exclure (.lobsiteignore) ; Codex ne doit jamais passer --include-secrets.
Est-ce que cela fonctionne avec Codex dans l’IDE ?
Oui. L’extension exécute le même agent : elle lit le même AGENTS.md, et la commande se comporte de la même façon.