Agent Skills › rcarmo/piclaw › token-chart

token-chart

GitHub

生成Token使用量图表，支持按天、模型或成本统计，可从数据库或会话文件读取数据，并通过IPC推送到Web UI时间线展示。

runtime/skills/operator/token-chart/SKILL.md rcarmo/piclaw

Trigger Scenarios

需要可视化Token消耗趋势分析不同Provider或Model的使用分布估算API调用成本

Install

npx skills add rcarmo/piclaw --skill token-chart -g -y

More Options

Non-standard path

npx skills add https://github.com/rcarmo/piclaw/tree/main/runtime/skills/operator/token-chart -g -y

Use without installing

npx skills use rcarmo/piclaw@token-chart

指定 Agent (Claude Code)

npx skills add rcarmo/piclaw --skill token-chart -a claude-code -g -y

安装 repo 全部 skill

npx skills add rcarmo/piclaw --all -g -y

预览 repo 内 skill

npx skills add rcarmo/piclaw --list

SKILL.md

Frontmatter

{
    "name": "token-chart",
    "description": "Generate a 7-day token usage chart (all chats) and post it to the web UI timeline.",
    "distribution": "public"
}

Token chart

Generate token-usage charts from the database or from session files.

Modes

default — daily stacked token-usage bars across the last N days
provider-model — stacked usage grouped by provider + model for attribution by model family
provider-model-cost — estimated cost grouped by provider + model using the pricing reference bundled with the script

Examples

Default chart:

bun /workspace/piclaw/runtime/skills/operator/token-chart/token-chart.ts

Provider + model chart:

bun /workspace/piclaw/runtime/skills/operator/token-chart/token-chart.ts --mode provider-model

Estimated provider + model cost chart:

bun /workspace/piclaw/runtime/skills/operator/token-chart/token-chart.ts --mode provider-model-cost

Post to the web chat via IPC:

bun /workspace/piclaw/runtime/skills/operator/token-chart/token-chart.ts --ipc

Post via IPC and allow a Pushover nudge:

bun /workspace/piclaw/runtime/skills/operator/token-chart/token-chart.ts --ipc --nudge

Data sources

default source: token_usage rows in ${PICLAW_STORE}/messages.db
--source sessions: read usage from session files under ${PICLAW_DATA}/sessions instead of SQLite
--sessions-dir <dir>: override the session-file location explicitly

Use --source sessions when DB-backed token usage is unavailable or when you want to inspect raw session-file history directly.

Output behaviour

--ipc writes an IPC message JSON file and, if needed, an SVG media file so piclaw posts the chart to the web timeline.
without --ipc, the script writes markdown to stdout with an embedded SVG data URL plus summary text.
--output-svg <path> writes the SVG to a file in either mode.

Notes

Numbers are formatted with compact K / M labels.
The estimated cost mode uses provider-model-pricing-reference.ts, the route-specific pricing-2026-09-05.json snapshot, and the human-readable note provider-model-pricing-reference.md.
This chart resolver estimates base-tier API value. Request-level long-context tiers, subscription allowances and actual invoices require separate analysis.
Use this on demand unless you intentionally wire it into a scheduled task.