agentguard-burn

The short name for AgentGuard Burn (@agentguard-run/burn).

npx agentguard-burn why

why shows where one Claude Code or Codex session's tokens went: sub-agent fan-out, history re-sent, cache rewrites and the rest, with API list-price equivalents. Every dollar figure is a list-price equivalent, not a bill. It reads the usage your host already saved on your machine; nothing is uploaded.

Every Burn command works the same way through this name, for example npx agentguard-burn rewrites or npx agentguard-burn resume --once --reason "...". The report prints in Latin American Spanish or Brazilian Portuguese when your computer is set to those languages, or with --lang es or --lang pt.

This package contains only a launcher. It installs @agentguard-run/burn and runs it with your arguments. Full documentation: https://agentguard.run/burn

Plain npx agentguard-burn shows three starting points: why for your last session, calendar for every day, and card for an image to share. Use npx agentguard-burn --help all for all commands. Burn prints its version first in why and calendar text reports.

With no sessions, all three commands print the same guidance and the actual folders checked, then exit 0. No card image is created. why --json always prints JSON to stdout, including found: false, looked_in, next and version in the empty case. Burn honors CLAUDE_CONFIG_DIR/projects and CODEX_HOME/sessions, falling back to ~/.claude/projects and ~/.codex/sessions when the respective variable is unset or empty.

A global install pins an old version: npx agentguard-burn why can keep using it. Run npx agentguard-burn@latest why for the latest release, or remove the old global install with npm rm -g @agentguard-run/burn (scoped package) or npm rm -g agentguard-burn (this wrapper).

AgentGuard is a registered trademark of Dunecrest Ventures Inc.