// Generate a 7-day token usage chart (all chats) and post it to the web UI timeline.
| name | token-chart |
| description | Generate a 7-day token usage chart (all chats) and post it to the web UI timeline. |
| distribution | public |
Generate token-usage charts from the database or from session files.
default — daily stacked token-usage bars across the last N daysprovider-model — stacked usage grouped by provider + model for attribution by model familyprovider-model-cost — estimated cost grouped by provider + model using the pricing reference bundled with the scriptDefault 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
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 explicitlyUse --source sessions when DB-backed token usage is unavailable or when you want to inspect raw session-file history directly.
--ipc writes an IPC message JSON file and, if needed, an SVG media file so piclaw posts the chart to the web timeline.--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.K / M labels.provider-model-pricing-reference.ts and the human-readable note provider-model-pricing-reference.md.Search the web via SearXNG (or DuckDuckGo fallback) and optionally fetch result pages as raw Markdown content.
Search via SearXNG (or DuckDuckGo fallback), fetch top results, and return sentence-level summaries plus optional converted page content.
Diagnose and fix issues with the Pibox container environment — tools, paths, mounts, pi configuration.
Reinstall piclaw from workspace source and force-restart the running process. Use after making code changes to piclaw.
Situate yourself by generating a 1-page situation report and maintaining Obsidian-style daily summary notes.
Author Adaptive Cards for the current PiClaw web environment. Use when you need a prompt pattern, supported payload shape, or reusable card templates for structured web interactions.