Codex di OpenAI legge AGENTS.md per capire come funziona un progetto. Dagli una breve sezione «Deploying» e può mettere online il sito con un comando, poi darti l'indirizzo e un link per tenere il sito. Prima c'è solo una cosa da sistemare: la sandbox, perché un deploy ha bisogno della rete.
Come funziona
- Aggiungi la sezione qui sotto ad AGENTS.md, così Codex conosce il comando e sa cosa dirti dopo.
- Lascia che il comando raggiunga la rete. Codex esegue i comandi in una sandbox, e il deploy deve parlare con lobsite.com (vedi Accesso alla rete).
- Chiedi a Codex di pubblicare. Fa la build, esegue
npx -y lobsite --yese ti riferisce l'URL e il link per rivendicarlo. Il sito dura 6 ore, a meno che tu non apra il link e acceda.
La sezione per AGENTS.md
Incolla questo nell'AGENTS.md del progetto. Anche gli altri agenti che leggono il file (Cursor, Gemini CLI, Copilot e altri) la usano:
## 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 capisce di girare sotto Codex dalla variabile CODEX_SANDBOX: non fa domande e stampa righe semplici.
Accesso alla rete
La sandbox di Codex può bloccare l'accesso alla rete dei comandi, e allora il deploy fallisce con un errore di connessione invece che con un errore di Lobsite. Per la Codex CLI, consenti la rete ai comandi del workspace in ~/.codex/config.toml:
[sandbox_workspace_write]
network_access = true
Oppure approva il comando quando Codex chiede di eseguirlo fuori dalla sandbox. Nelle attività di Codex in cloud, l'accesso a internet dell'agente è un'impostazione dell'ambiente; consenti lobsite.com e upload.lobsite.app (e il registro npm, per npx).
Il server MCP, o curl
La Codex CLI può anche avviare il server MCP di Lobsite, che le dà deploy, list_sites, list_deploys, rollback, promote e whoami come strumenti. Aggiungilo a ~/.codex/config.toml:
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Dove Node non è installato, una pagina (o pochi file) si pubblica con curl, che risponde con l'URL e il link per rivendicarla:
curl --data-binary @index.html https://lobsite.com/api/v1/drop
Nessuna domanda quando lo usa un agente, e una riga Tell the user: con l'URL e il link per rivendicarlo.
Niente Node? curl --data-binary @index.html lobsite.com/api/v1/drop risponde con l'URL.
npx lobsite mcp per gli agenti di coding, lobsite.com/api/mcp per gli assistenti in chat.
I file vengono salvati in base al loro hash. Ripubblicare un sito invariato carica 0 byte.
Anteprima prima di andare online. Rollback in un clic, reindirizzamenti compresi.
Ogni limite è pubblicato e ogni errore ti dice cosa fare dopo.
Comando, server MCP o curl
npx -y lobsite --yes |
Server MCP | curl | |
|---|---|---|---|
| Richiede | Node e rete | Node e rete | Solo rete |
| Cosa carica | La cartella generata, solo i file modificati | La cartella generata, solo i file modificati | I file che indichi, fino a 25 MB |
| Aggiorna lo stesso sito | Sì, lobsite.toml lo ricorda |
Sì | Sì, con ?site= e il token per rivendicarlo |
| Rollback, elenco dei deploy | Con altri comandi | Come strumenti | No |
| Configurazione | Sezione in AGENTS.md | Voce in config.toml |
Nessuna |
Inizia con il comando; aggiungi il server MCP se vuoi che Codex gestisca i deploy, e tieni curl per le sandbox senza Node.
Domande frequenti
Perché il deploy fallisce con un errore di rete?
La sandbox ha impedito al comando di raggiungere lobsite.com. Attiva l'accesso alla rete per il workspace, approva il comando fuori dalla sandbox o consenti i domini nel tuo ambiente Codex in cloud.
Codex ha bisogno del mio account Lobsite?
No. Senza account il sito dura 6 ore e Codex ti dà il link per rivendicarlo. Per pubblicare nel tuo account, esegui tu una volta npx lobsite login; l'accesso avviene in un browser.
Codex può pubblicare prima un'anteprima?
Sì. npx -y lobsite --yes --preview dà al deploy un suo URL e lascia il sito online com'era. npx lobsite promote <id> lo mette online.
E se il mio progetto ha un file .env?
I file segreti non vengono mai caricati. Fermano il deploy con un errore che spiega come escluderli (.lobsiteignore); Codex non dovrebbe mai passare --include-secrets.
Funziona con Codex nell'IDE?
Sì. L'estensione esegue lo stesso agente, quindi legge lo stesso AGENTS.md, e il comando si comporta allo stesso modo.