Dokumentasjon /

AI-agenter

Kodeagenter (Claude Code, Cursor, Codex og andre) deployer med den samme CLI-en som mennesker, og chatassistenter uten filsystem deployer gjennom en ekstern MCP-server. Denne siden viser hvordan du setter opp hver av dem.

npx -y lobsite --yes

Slik fungerer agentmodus

CLI-en vet at den kjører under en agent fra variablene agenter setter: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT og AGENT. Sett LOBSITE_AGENT=<name> for å navngi en annen agent, eller LOBSITE_AGENT=0 for å slå av agentmodus. Under en agent:

• Det spørres aldri om noe. Første deploy av en mappe skriver ut sammendraget og fortsetter; kommandoer som ikke kan angres, krever --yes.
• Det er ingen farger, spinnere, QR-koder eller kopiering til utklippstavlen, bare enkle linjer.
• En deploy slutter med en linje skrevet for at agenten skal gi den videre:

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).

Nettsteder som deployes uten konto, varer i 6 timer. Krav-lenken beholder nettstedet: personen åpner den og logger inn, uten å røre en terminal. Kjører du samme kommando igjen, oppdateres det samme nettstedet, fordi lobsite.toml husker det.

Claude Code

Claude Code kan deploye med bare skallkommandoen. For at den skal bruke Lobsite hver gang, legg til en linje i prosjektets CLAUDE.md:

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

Eller legg til MCP-serveren, som gir Claude verktøy for å deploye, liste nettsteder og deployer, rulle tilbake og publisere:

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

Cursor

Legg til MCP-serveren i .cursor/mcp.json:

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

Eller legg til en prosjektregel i .cursor/rules/ med seksjonen fra AGENTS.md.

Codex og andre agenter

Codex og de andre agentene som leser AGENTS.md, plukker opp en seksjon som denne. Lim den inn i prosjektets AGENTS.md:

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

Enhver agent som snakker MCP over stdin/stdout, kan kjøre npx -y lobsite@latest mcp i stedet.

ChatGPT og Claude.ai

Chatassistenter skriver sider, men har ingen mappe å deploye. Legg til Lobsite som en egendefinert kobling (en MCP-server) med denne URL-en:

https://lobsite.com/api/mcp

Den snakker Streamable HTTP og har ett verktøy, deploy_files, som tar imot innholdet i filene. Be så assistenten legge ut siden. Nettsteder som deployes slik, har ingen konto: svaret inneholder krav-lenken som beholder dem.

Uten Node: curl

Der npx ikke kan kjøre, deployer én curl-kommando en side eller noen få filer og svarer med URL-en, krav-lenken og hvordan du oppdaterer nettstedet:

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

For å oppdatere det samme midlertidige nettstedet, send med navnet og krav-tokenet fra det første svaret:

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

?preview=1 deployer uten å endre det live nettstedet. En direkte deploy tar opptil 25 MB. Legg til ?format=json for et JSON-svar.

MCP-verktøy

De lokale verktøyene kjører CLI-kommandoene med --json --yes og tar path, prosjektmappen (som standard mappen serveren startet i). deploy svarer først med linjen «Tell the user». Innlogging og sletting av nettsteder er ikke verktøy: det ene trenger personen i en nettleser, det andre kan ikke angres.

JSON-utdata

--json skriver ut ett JSON-objekt på stdout, med logger på 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 og expires_at er null for nettsteder med konto. En feil er { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Ta beslutninger ut fra code, som aldri endres (se Feil), og prøv på nytt bare når retryable er true.