Agent Skills › rcarmo/piclaw › token-chart

token-chart

GitHub

生成过去7天Token使用量图表，支持按日、提供商+模型及成本分组统计。可从数据库或会话文件读取数据，输出SVG图表并通过IPC推送至Web UI时间线展示。

skel/.pi/skills/token-chart/SKILL.md rcarmo/piclaw

Trigger Scenarios

需要查看Token使用情况生成使用量统计图表分析模型调用成本

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/skel/.pi/skills/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/.pi/skills/token-chart/token-chart.ts

Provider + model chart:

bun /workspace/.pi/skills/token-chart/token-chart.ts --mode provider-model

Estimated provider + model cost chart:

bun /workspace/.pi/skills/token-chart/token-chart.ts --mode provider-model-cost

Post to the web chat via IPC:

bun /workspace/.pi/skills/token-chart/token-chart.ts --ipc

Post via IPC and allow a Pushover nudge:

bun /workspace/.pi/skills/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.