burner-cli

The CLI for burner.dev — deploy ephemeral preview environments from the command line. Get a public URL for any web app in ~30 seconds.

Install

npm install -g burner-cli

Quick start

# Authenticate via GitHub
burner login

# Deploy a preview
burner deploy ./my-app -c "npm install && npm start" -p 3000

# See your live previews
burner ls

# Tear one down (or let it auto-expire)
burner rm <id-or-url>

Commands

burner login

Authenticate with your GitHub account. Opens your browser to complete the OAuth flow, then saves your API key to ~/.config/burner/config.json.

burner deploy [dir]

Deploy a directory as a preview environment.

| Flag | Description | Default | |------|-------------|---------| | -c, --command <cmd> | Command to start the server (required) | — | | -p, --port <number> | Port the server listens on | 3000 | | -e, --env <KEY=VALUE> | Environment variable (repeatable) | — | | --ttl <minutes> | Time before auto-expiry (5-240) | 45 |

burner deploy ./my-app \
  -c "npm install && npm start" \
  -p 8080 \
  -e NODE_ENV=production \
  -e API_KEY=sk-123 \
  --ttl 120

burner ls

List your preview environments. Optionally filter by status with --status <status>.

burner rm <id-or-url>

Destroy a preview. Accepts a preview ID (prev_...), a full URL, or a subdomain.

burner whoami

Show your account info and usage stats.

burner mcp

Start a Model Context Protocol server over stdio, so AI agents (Claude, Cursor, etc.) can deploy and manage previews on your behalf.

Add it to your MCP client config:

{
  "mcpServers": {
    "burner": {
      "command": "npx",
      "args": ["-y", "burner-cli", "mcp"]
    }
  }
}

Authentication

You can authenticate in two ways:

• burner login — saves credentials to ~/.config/burner/config.json
• BURNER_API_KEY environment variable — useful in CI or scripted environments

Supported environments

Burner currently supports Node.js projects only (React, Next.js, Vite, Astro, Express, etc.). Python, Ruby, Java, and other runtimes are coming soon.

Requirements

Node.js >= 22.0.0

License

MIT