Codex dari OpenAI membaca AGENTS.md untuk mempelajari cara kerja proyek. Beri bagian "Deploying" singkat dan Codex dapat menayangkan situs dengan satu perintah, lalu memberi Anda alamat dan tautan untuk menyimpan situs. Satu hal yang perlu diselesaikan dulu adalah sandbox: deploy memerlukan jaringan.
Cara kerjanya
- Tambahkan bagian di bawah ke AGENTS.md, agar Codex tahu perintahnya dan apa yang harus disampaikan setelahnya.
- Izinkan perintah menjangkau jaringan. Codex menjalankan perintah di sandbox, dan deploy harus berkomunikasi dengan lobsite.com (lihat Akses jaringan).
- Minta Codex melakukan deploy. Codex melakukan build, menjalankan
npx -y lobsite --yes, dan menyampaikan URL serta tautan klaim. Situs bertahan 6 jam kecuali Anda membuka tautan dan masuk.
Bagian AGENTS.md
Tempelkan ini ke AGENTS.md proyek. Agen lain yang membaca file ini (Cursor, Gemini CLI, Copilot, dan lainnya) juga memakainya:
## 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 tahu dirinya berjalan di bawah Codex dari variabel CODEX_SANDBOX: tidak bertanya dan mencetak baris biasa.
Akses jaringan
Sandbox Codex dapat memblokir akses jaringan untuk perintah, dan deploy lalu gagal dengan error koneksi, bukan error Lobsite. Untuk Codex CLI, izinkan jaringan bagi perintah di workspace pada ~/.codex/config.toml:
[sandbox_workspace_write]
network_access = true
Atau setujui perintah saat Codex meminta menjalankannya di luar sandbox. Di tugas cloud Codex, akses internet agen adalah pengaturan lingkungan; izinkan lobsite.com dan upload.lobsite.app (dan registri npm, untuk npx).
Server MCP, atau curl
Codex CLI juga dapat memulai server MCP Lobsite, yang memberinya deploy, list_sites, list_deploys, rollback, promote, dan whoami sebagai alat. Tambahkan ke ~/.codex/config.toml:
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Di tempat Node tidak terpasang, satu halaman (atau beberapa file) di-deploy dengan curl, yang menjawab dengan URL dan tautan klaim:
curl --data-binary @index.html https://lobsite.com/api/v1/drop
Tanpa pertanyaan saat dijalankan agen, dan baris Tell the user: berisi URL dan tautan klaim.
Tidak ada Node? curl --data-binary @index.html lobsite.com/api/v1/drop menjawab dengan URL.
npx lobsite mcp untuk agen coding, lobsite.com/api/mcp untuk asisten chat.
File disimpan berdasarkan hash-nya. Deploy ulang situs yang tidak berubah mengunggah 0 byte.
Pratinjau sebelum tayang. Rollback dengan satu klik, termasuk pengalihan.
Setiap batas dipublikasikan, dan setiap error memberi tahu langkah selanjutnya.
Perintah, server MCP, atau curl
npx -y lobsite --yes |
Server MCP | curl | |
|---|---|---|---|
| Memerlukan | Node dan jaringan | Node dan jaringan | Hanya jaringan |
| Yang diunggah | Folder hasil build, hanya file berubah | Folder hasil build, hanya file berubah | File yang Anda sebut, hingga 25 MB |
| Memperbarui situs yang sama | Ya, lobsite.toml mengingatnya |
Ya | Ya, dengan ?site= dan token klaim |
| Rollback, daftar deploy | Dengan perintah tambahan | Sebagai alat | Tidak |
| Penyiapan | Bagian AGENTS.md | Entri config.toml |
Tidak ada |
Mulai dengan perintah; tambahkan server MCP jika ingin Codex mengelola deploy, dan gunakan curl untuk sandbox tanpa Node.
Pertanyaan umum
Mengapa deploy gagal dengan error jaringan?
Sandbox menghentikan perintah menjangkau lobsite.com. Aktifkan akses jaringan untuk workspace, setujui perintah di luar sandbox, atau izinkan domain di lingkungan cloud Codex Anda.
Apakah Codex memerlukan akun Lobsite saya?
Tidak. Tanpa akun, situs bertahan 6 jam dan Codex memberi Anda tautan klaim. Untuk melakukan deploy ke akun Anda, jalankan npx lobsite login sendiri sekali; proses masuk terjadi di browser.
Bisakah Codex melakukan deploy pratinjau terlebih dahulu?
Ya. npx -y lobsite --yes --preview memberi deploy URL sendiri dan membiarkan situs aktif apa adanya. npx lobsite promote <id> menayangkannya.
Bagaimana jika proyek saya memiliki file .env?
File rahasia tidak pernah diunggah. File itu menghentikan deploy dengan error yang menjelaskan cara mengecualikannya (.lobsiteignore); Codex tidak boleh memberikan --include-secrets.
Apakah ini berfungsi untuk Codex di IDE?
Ya. Ekstensi menjalankan agen yang sama, sehingga membaca AGENTS.md yang sama, dan perintahnya berperilaku sama.