CLI Reference

The burner CLI lets you spin up, manage, and tear down burners from your terminal.

Installation

npm install -g burner-cli

Or use directly with npx burner-cli.

Global Options

FlagDescription
--api-url <url>Override the API base URL
--versionShow CLI version
--helpShow help

burner login

Authenticate with burner.dev via GitHub OAuth.

burner login

Opens your browser to sign in with GitHub. After authorizing, the page displays an API key. Paste it into the terminal prompt. The key is stored at ~/.config/burner/config.json.

You can also skip the login flow by setting the BURNER_API_KEY environment variable.

burner deploy

Spin up a burner from a local directory.

burner deploy [dir] --command <cmd> [options]
FlagRequiredDefaultDescription
[dir]No.Directory to deploy
-c, --command <cmd>Yes—Command to start the server
-p, --port <number>No3000Port your server listens on
-e, --env <KEY=VALUE>No—Environment variable (repeatable)
--ttl <minutes>No45Burner TTL in minutes (5–240)

Examples

# Vite React app
burner deploy . --command "npm run dev" --port 5173

# Next.js
burner deploy . --command "npm run dev"

# Express with env vars
burner deploy ./api --command "node server.js" --port 8080 \
  -e DATABASE_URL=postgres://... -e NODE_ENV=production

# Short TTL for a quick burner
burner deploy . --command "npm start" --ttl 10

burner ls

List your burners.

burner ls [--status <status>]

Shows a table of all your burners with their ID, subdomain, status, expiry, and command. Filter by status with --status running, --status failed, etc.

burner rm

Tear down a burner.

burner rm <id-or-subdomain-or-url>

Accepts a preview ID (prev_...), bare subdomain (icy-busy-pony-2718), or full URL.

burner whoami

Show your account info and usage stats.

burner whoami

Displays your plan, concurrent burner count, daily usage, and when your daily limit resets.

burner mcp

Start a stdio MCP server for AI agent integration.

burner mcp

See the MCP Integration guide for setup instructions.