Documentazione /

Agenti IA

Gli agenti di programmazione (Claude Code, Cursor, Codex e altri) pubblicano con la stessa CLI delle persone, e gli assistenti di chat senza filesystem pubblicano tramite un server MCP remoto. Questa pagina mostra come configurare ciascuno.

npx -y lobsite --yes

Come funziona la modalità agente

La CLI capisce di girare sotto un agente dalle variabili che gli agenti impostano: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT e AGENT. Imposta LOBSITE_AGENT=<name> per indicare un altro agente, o LOBSITE_AGENT=0 per disattivare la modalità agente. Sotto un agente:

• Non viene mai chiesto nulla. Il primo deploy di una cartella stampa il riepilogo e prosegue; i comandi che non si possono annullare richiedono --yes.
• Niente colori, animazioni, codici QR o copie negli appunti, solo righe semplici.
• Un deploy termina con una riga scritta perché l'agente la riferisca:

Tell the user: the site is live at https://quiet-fox-4821.lobsite.app. It's temporary and is removed in 6h. To keep it, open https://lobsite.com/claim/quiet-fox-4821#lob_claim_… and sign in (free).

I siti pubblicati senza account durano 6 ore. Il link per rivendicarlo tiene il sito: la persona lo apre e accede, senza toccare un terminale. Eseguire di nuovo lo stesso comando aggiorna lo stesso sito, perché lobsite.toml lo ricorda.

Claude Code

Claude Code può pubblicare con il solo comando di shell. Perché usi Lobsite ogni volta, aggiungi una riga al CLAUDE.md del progetto:

Deploy with `npx -y lobsite --yes` and relay the "Tell the user:" line from the output.

Oppure aggiungi il server MCP, che dà a Claude strumenti per pubblicare, elencare siti e deploy, fare rollback e mettere online:

claude mcp add lobsite -- npx -y lobsite@latest mcp

Cursor

Aggiungi il server MCP a .cursor/mcp.json:

{ "mcpServers": { "lobsite": { "command": "npx", "args": ["-y", "lobsite@latest", "mcp"] } } }

Oppure aggiungi una regola di progetto in .cursor/rules/ con la sezione di AGENTS.md.

Codex e altri agenti

Codex e gli altri agenti che leggono AGENTS.md recepiscono una sezione come questa. Incollala nell'AGENTS.md del progetto:

## 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`.

Qualsiasi agente che parla MCP tramite stdin/stdout può eseguire invece npx -y lobsite@latest mcp.

ChatGPT e Claude.ai

Gli assistenti di chat scrivono pagine ma non hanno una cartella da pubblicare. Aggiungi Lobsite come connettore personalizzato (un server MCP) con questo URL:

https://lobsite.com/api/mcp

Usa Streamable HTTP e ha un solo strumento, deploy_files, che riceve il contenuto dei file. Poi chiedi all'assistente di mettere online la pagina. I siti pubblicati così non hanno un account: la risposta contiene il link per rivendicarli e tenerli.

Senza Node: curl

Dove npx non può girare, un comando curl pubblica una pagina o pochi file e risponde con l'URL, il link per rivendicarla e come aggiornare il sito:

curl --data-binary @index.html https://lobsite.com/api/v1/drop
curl -F index.html=@index.html -F css/site.css=@site.css https://lobsite.com/api/v1/drop

Per aggiornare lo stesso sito temporaneo, passa il suo nome e il token per rivendicarlo dalla prima risposta:

curl --data-binary @index.html -H "Authorization: Bearer lob_claim_…" "https://lobsite.com/api/v1/drop?site=quiet-fox-4821"

?preview=1 pubblica senza cambiare il sito online. Un deploy diretto accetta fino a 25 MB. Aggiungi ?format=json per una risposta in JSON.

Strumenti MCP

Gli strumenti locali eseguono i comandi della CLI con --json --yes e ricevono path, la cartella del progetto (di default, quella in cui è stato avviato il server). deploy risponde prima con la riga «Tell the user». Accedere ed eliminare siti non sono strumenti: il primo richiede la persona in un browser, il secondo non si può annullare.

Output JSON

--json stampa un oggetto JSON su stdout, con i log su stderr:

{
  "site": "quiet-fox-4821",
  "deploy_id": "d7k2m9qa",
  "url": "https://quiet-fox-4821.lobsite.app",
  "preview_url": "https://d7k2m9qa--quiet-fox-4821.lobsite.app",
  "live": true,
  "expires_at": "2026-10-13T16:20:38Z",
  "claim_url": "https://lobsite.com/claim/quiet-fox-4821#lob_claim_…",
  "files": { "total": 42, "uploaded": 3 },
  "bytes_uploaded": 14336,
  "duration_ms": 812
}

claim_url ed expires_at sono null per i siti con un account. Un fallimento è { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Decidi in base a code, che non cambia mai (vedi Errori), e riprova solo quando retryable è true.