How do I install the Token Burn Monitor skill?

Run npx skillmds@latest add dvcrn/token-burn-monitor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Token Burn Monitor safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Token Burn Monitor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Token Burn Monitor free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Token Burn Monitor?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Token Burn Monitor by dvcrn — Agent Skill

Name: Token Burn Monitor
Rating: 4.2 (5 reviews)
Author: dvcrn

Token Burn Monitor

Real-time token consumption monitoring dashboard for OpenClaw agents. Tracks per-agent token usage, cost breakdown by model, cache hit rates, cron job status, and 30-day historical trends. Use when setting up cost monitoring, checking daily token burn, or reviewing cron job health. User prompts are redacted by default.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Token Burn Monitor

Zero-dependency Node.js dashboard. Core API + swappable frontend themes.

Architecture

server.js          → Core API (stable, don't modify)
themes/default/    → Default dark dashboard theme
themes/<custom>/   → User/agent-generated themes
API.md             → API contract for theme developers
config.json        → Port, theme, agents, pricing overrides

Quick Start

bash start.sh            # Start (default port 3847)
bash start.sh status     # Check status
bash start.sh restart    # Restart after config change
bash start.sh stop       # Stop

Configuration

Copy config.default.json to config.json:

{
  "port": 3847,
  "theme": "default",
  "agents": {
    "main": { "name": "Karl", "icon": "/assets/karl.png" }
  },
  "modelPricing": {}
}

theme: Directory name under themes/. Default: "default"
agents: Display names/icons. Auto-discovered; config only overrides display.
port: Also settable via PORT env var.
modelPricing: Override/add model pricing ($/1M tokens).

Set OPENCLAW_AGENTS_DIR to override agent directory (default: /home/node/.openclaw/agents).

Themes

Themes live in themes/<name>/. Minimum: one index.html that fetches data from the API.

To create a custom theme:

Read API.md for all available endpoints
Create themes/my-theme/index.html
Set "theme": "my-theme" in config.json
Restart

The default theme (themes/default/) is a full reference implementation.

API Overview

All endpoints return JSON. GET-only. Server binds to localhost. Full docs in API.md.

Endpoint	Description
`GET /api/config`	Agent names and icons
`GET /api/stats?date=`	All agents aggregated
`GET /api/agent/:id?date=`	Single agent with per-call breakdown
`GET /api/history?days=`	30-day cost history
`GET /api/pricing`	Model pricing table
`GET /api/crons`	Scheduled jobs (read from filesystem)
`GET /api/cron/:id/runs`	Job run history

Security

Server binds to 127.0.0.1 by default (localhost only)
No shell execution — all data read from filesystem
No outbound network requests — default theme uses system fonts
User prompts redacted by default ([redacted]), opt-in via showPrompts: true in config
HTML responses include CSP: connect-src 'self'; font-src 'self'
GET-only — all other HTTP methods rejected

Troubleshooting

No data: Verify OPENCLAW_AGENTS_DIR points to correct agents directory.
Port conflict: PORT=4000 bash start.sh
Theme not loading: Check themes/<name>/index.html exists.

---name: token-burn-monitordescription: Real-time token consumption monitoring dashboard for OpenClaw agents. Tracks per-agent token usage, cost breakdown by model, cache hit rates, cron job status, and 30-day historical trends. Use when setting up cost monitoring, checking daily token burn, or reviewing cron job health. User prompts are redacted by default.---# Token Burn MonitorZero-dependency Node.js dashboard. Core API + swappable frontend themes.## Architecture```server.js → Core API (stable, don't modify)themes/default/ → Default dark dashboard themethemes/<custom>/ → User/agent-generated themesAPI.md → API contract for theme developersconfig.json → Port, theme, agents, pricing overrides```## Quick Start```bashbash start.sh # Start (default port 3847)bash start.sh status # Check statusbash start.sh restart # Restart after config changebash start.sh stop # Stop```## ConfigurationCopy `config.default.json` to `config.json`:```json{ "port": 3847, "theme": "default", "agents": { "main": { "name": "Karl", "icon": "/assets/karl.png" } }, "modelPricing": {}}```- **theme**: Directory name under `themes/`. Default: `"default"`- **agents**: Display names/icons. Auto-discovered; config only overrides display.- **port**: Also settable via `PORT` env var.- **modelPricing**: Override/add model pricing ($/1M tokens).Set `OPENCLAW_AGENTS_DIR` to override agent directory (default: `/home/node/.openclaw/agents`).## ThemesThemes live in `themes/<name>/`. Minimum: one `index.html` that fetches data from the API.To create a custom theme:1. Read `API.md` for all available endpoints2. Create `themes/my-theme/index.html`3. Set `"theme": "my-theme"` in config.json4. RestartThe default theme (`themes/default/`) is a full reference implementation.## API OverviewAll endpoints return JSON. GET-only. Server binds to localhost. Full docs in `API.md`.| Endpoint | Description ||---|---|| `GET /api/config` | Agent names and icons || `GET /api/stats?date=` | All agents aggregated || `GET /api/agent/:id?date=` | Single agent with per-call breakdown || `GET /api/history?days=` | 30-day cost history || `GET /api/pricing` | Model pricing table || `GET /api/crons` | Scheduled jobs (read from filesystem) || `GET /api/cron/:id/runs` | Job run history |## Security- Server binds to `127.0.0.1` by default (localhost only)- No shell execution — all data read from filesystem- No outbound network requests — default theme uses system fonts- User prompts redacted by default (`[redacted]`), opt-in via `showPrompts: true` in config- HTML responses include CSP: `connect-src 'self'; font-src 'self'`- GET-only — all other HTTP methods rejected## Troubleshooting- **No data**: Verify `OPENCLAW_AGENTS_DIR` points to correct agents directory.- **Port conflict**: `PORT=4000 bash start.sh`- **Theme not loading**: Check `themes/<name>/index.html` exists.

Frequently asked questions

Token Burn Monitor

File contents

Token Burn Monitor

Architecture

Quick Start

Configuration

Themes

API Overview

Security

Troubleshooting

Related skills

Frequently asked questions

How do I install the Token Burn Monitor skill?

What does the Token Burn Monitor skill do?

Is Token Burn Monitor safe to use?

Which AI agents work with Token Burn Monitor?

Is Token Burn Monitor free to use?

Who published Token Burn Monitor?