Burnlist

Burnlist is a real-time, non-invasive tracker for agents. It tracks a repo-local, shrinking work queue in a read-only local dashboard and stays out of implementation, testing, and delivery.

What ships

• One agent skill for creating, hardening, executing, and maintaining Burnlists.
• A local observer dashboard with two default Ovens:
  • Checklist tracks completion of the active work queue.
  • Target tracks a measured value against a specific goal and focuses work on the next actionable constraint.
• Custom Ovens built from Markdown instructions and a non-executable detail skeleton.

An Oven is a declarative recipe for an agent run. It defines the goal, canonical state, inputs, evidence, and normalized data presentation. It cannot execute code, produce project data, or change project state. See the Oven contract.

Anyone can create a custom Oven. Burnlist stores it under local state and snapshots it when a run starts.

Install

npm install --global burnlist

This installs the burnlist command and registers the bundled skill under $HOME/.agents/skills.

Start the local dashboard from any project:

burnlist

To uninstall, run:

burnlist uninstall

Verify

npm run build:dashboard
npm run verify
npm run verify:clean
npm run verify:package
npm run test:global-install

verify:clean runs the source, npm payload, and isolated global install checks from a temporary copy.

Boundaries

Keep .local/, real notes/burnlists/ history, dashboard build output, screenshots, and npm tarballs out of version control. Custom Ovens and Run snapshots live under ignored .local/burnlist/ state.

License

GPL-3.0-or-later.