burn0 init

Configures burn0 for your project. Runs automatically on npm install (in interactive terminals) or manually:

npx burn0 init

What it does

API key

Choose to paste an existing key, get a free one at burn0.dev/api, or skip (local mode).

Detect services

Scans your package.json and codebase for known API services. Shows what it found with auto-priced or plan-selection prompts.

Configure

Writes .burn0/config.json, adds .burn0/ and .env to .gitignore.

Example

  burn0 — track every API cost

  API key?
    ○ Paste key
    ○ Get one free → burn0.dev/api
    ○ Skip — local mode

  Auto-detected 4 services:

    ✓  OpenAI               auto-priced
    ✓  Stripe               auto-priced
    ✓  Supabase             needs plan
    ✓  Vercel               needs plan

  Supabase — which plan? Pro — $25/mo
  Vercel — which plan? Pro — $20/mo

  Add other services you use? (Y/n)

  ✓ Added .env to .gitignore (protects your API keys)
  ✓ Config synced to burn0.dev

  ✓ Setup complete

  Add this to your entry file:
    import '@burn0/burn0'

  Then run your app to see costs.

Files created

File	Purpose
`.burn0/config.json`	Project name, services, plan selections
`.env`	`BURN0_API_KEY` (if provided)
`.env.example`	`BURN0_API_KEY=` placeholder

Re-running

Run npx burn0 init again at any time to reconfigure. It overwrites the existing config.

CI / Non-interactive

In CI/Docker (no TTY), init doesn’t run. It prints:

[burn0] Run "npx burn0 init" to set up cost tracking.

Getting Started

CLI

SDK

Dashboard

Reference

burn0 init

burn0 init

What it does

Example

Files created

Re-running

CI / Non-interactive

​burn0 init

​What it does

​Example

​Files created

​Re-running

​CI / Non-interactive

burn0 init

What it does

Example

Files created

Re-running

CI / Non-interactive