Documentation

burn is a local proxy and a SQLite ledger. These guides cover the route from your SDK to the database, and every command that reads it. The command reference is checked against the source that ships in the package.

$ npx @xnah/burn proxy

Start here

Getting startedInstall burn, route your first request through the proxy, and see what it cost.

Using burn

SetupWire up OpenAI, Anthropic, any OpenAI-compatible API, burn run, burn env and tags.DashboardWhat burn ui shows, what each range means, and how demo mode works.PricingWhere prices come from, how the 24 hour cache works, and how to fix an unpriced model.BudgetsSet a daily spend limit that warns once, or blocks with HTTP 429.

Reference

CLI referenceEvery burn command and flag, checked against the source.Configurationconfig.json, BURN_HOME, BURN_OFFLINE, BURN_PRICE_URL and the default ports.Troubleshooting and FAQNo rows, no price, a port in use, a blocked request, and other common questions.

Not sure where to start?

The getting started guide takes a single request from your SDK to a row in SQLite, then shows the three commands that read it.

Getting started