O Codex, da OpenAI, lê o AGENTS.md para entender como um projeto funciona. Dê a ele uma seção curta de "Deploying" e ele consegue colocar o site no ar com um comando e depois te passar o endereço e um link que mantém o site. Só uma coisa precisa ser resolvida antes: o sandbox, porque um deploy precisa de rede.
Como funciona
- Adicione a seção abaixo ao AGENTS.md, para o Codex saber o comando e o que te dizer depois.
- Deixe o comando acessar a rede. O Codex roda comandos num sandbox, e o deploy precisa falar com lobsite.com (veja Acesso à rede).
- Peça ao Codex para publicar. Ele faz o build, roda
npx -y lobsite --yese repassa a URL e o link de resgate. O site dura 6 horas, a menos que você abra o link e entre.
A seção do AGENTS.md
Cole isto no AGENTS.md do projeto. Outros agentes que leem o arquivo (Cursor, Gemini CLI, Copilot e outros) também a usam:
## 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`.
A CLI sabe que está rodando sob o Codex pela variável CODEX_SANDBOX: não faz perguntas e imprime linhas simples.
Acesso à rede
O sandbox do Codex pode bloquear o acesso à rede dos comandos, e aí o deploy falha com um erro de conexão em vez de um erro do Lobsite. Na Codex CLI, libere a rede para os comandos do workspace em ~/.codex/config.toml:
[sandbox_workspace_write]
network_access = true
Ou aprove o comando quando o Codex pedir para rodá-lo fora do sandbox. Nas tarefas do Codex na nuvem, o acesso do agente à internet é uma configuração do ambiente; libere lobsite.com e upload.lobsite.app (e o registro do npm, para o npx).
O servidor MCP, ou curl
A Codex CLI também pode iniciar o servidor MCP do Lobsite, que lhe dá deploy, list_sites, list_deploys, rollback, promote e whoami como ferramentas. Adicione-o ao ~/.codex/config.toml:
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Onde o Node não está instalado, uma página (ou alguns arquivos) é publicada com curl, que responde com a URL e o link de resgate:
curl --data-binary @index.html https://lobsite.com/api/v1/drop
Nenhuma pergunta quando roda sob um agente, e uma linha Tell the user: com a URL e o link de resgate.
Sem Node? curl --data-binary @index.html lobsite.com/api/v1/drop responde com a URL.
npx lobsite mcp para agentes de código, lobsite.com/api/mcp para assistentes de chat.
Os arquivos são guardados pelo hash. Refazer o deploy de um site sem mudanças envia 0 bytes.
Veja a prévia antes de ir ao ar. Volte atrás com um clique, redirecionamentos inclusos.
Todo limite é publicado, e todo erro diz o que fazer em seguida.
Comando, servidor MCP ou curl
npx -y lobsite --yes |
Servidor MCP | curl | |
|---|---|---|---|
| Precisa de | Node e rede | Node e rede | Só rede |
| O que envia | A pasta gerada, só os arquivos alterados | A pasta gerada, só os arquivos alterados | Os arquivos que você indicar, até 25 MB |
| Atualiza o mesmo site | Sim, o lobsite.toml o lembra |
Sim | Sim, com ?site= e o token de resgate |
| Rollback, listar deploys | Com mais comandos | Como ferramentas | Não |
| Configuração | Seção no AGENTS.md | Entrada no config.toml |
Nenhuma |
Comece pelo comando; adicione o servidor MCP se quiser que o Codex gerencie deploys, e deixe o curl para sandboxes sem Node.
Perguntas frequentes
Por que o deploy falha com um erro de rede?
O sandbox impediu o comando de chegar a lobsite.com. Ative o acesso à rede para o workspace, aprove o comando fora do sandbox ou libere os domínios no seu ambiente do Codex na nuvem.
O Codex precisa da minha conta do Lobsite?
Não. Sem conta, o site dura 6 horas e o Codex te dá o link de resgate. Para publicar na sua conta, rode você mesmo npx lobsite login uma vez; o login acontece num navegador.
O Codex pode publicar uma prévia primeiro?
Sim. npx -y lobsite --yes --preview dá ao deploy uma URL própria e deixa o site no ar como estava. npx lobsite promote <id> o coloca no ar.
E se meu projeto tiver um arquivo .env?
Arquivos secretos nunca são enviados. Eles interrompem o deploy com um erro que explica como deixá-los de fora (.lobsiteignore); o Codex nunca deve passar --include-secrets.
Funciona com o Codex na IDE?
Sim. A extensão roda o mesmo agente, então lê o mesmo AGENTS.md, e o comando se comporta igual.