usage

name	usage
description	Show usage cost summary — session, today, last 30 days. OpenClaw-compatible format. Works from CLI or messaging. Triggers on /usage, /agent:usage, "cuanto gasté", "agent usage", "cost".
user-invocable	true

/usage — Cost Summary

Show usage costs in the OpenClaw-compatible format. Works from CLI or messaging channels.

Output format (matches OpenClaw exactly)

💸 Usage cost
Session <cost> · <tokens> tokens
Today <cost>
Last 30d <cost>

Subcommands

• /usage — show the cost summary (default)
• /usage tokens — compact token display
• /usage full — verbose token + cost
• /usage cost — same as default

Steps

1. Detect surface (CLI vs messaging channel).

2. Try to read session cost data from Claude Code's session store:

   ls ~/.claude/projects/*/\*.jsonl 2>/dev/null | head -3
   

   NOTE: Claude Code stores session data in ~/.claude/projects/<slug>/*.jsonl. The plugin cannot reliably read these because:

   • The session slug depends on the current cwd
   • The format is internal to Claude Code
   • Token counts per session are not always available to skills

3. Fall back to estimate from memory/dreams:

   • Call agent_status MCP tool → get file/chunk counts
   • Bash: du -sh memory/ | awk '{print $1}' → memory dir size
   • Bash: wc -l memory/.dreams/events.jsonl 2>/dev/null | awk '{print $1}' → event count

4. Build the response in OpenClaw format:

When cost data is available

💸 Usage cost
Session $0.42 · 125k tokens
Today $1.23
Last 30d $34.56

When cost data is NOT available (most likely case)

💸 Usage cost
Session n/a (run native /cost or /usage in CLI for tokens)
Today n/a
Last 30d n/a

📊 Agent resources
Memory: <size>, <N> files, <M> chunks
Dreams: <events> events, <unique> unique memories

5. Format per surface:

   • CLI: standard markdown
   • WhatsApp: single *bold*
   • Telegram: **bold**

6. Reply tool if on messaging channel.

Important

• Claude Code does not expose session cost data to plugin skills directly.
• The honest answer is "n/a — use native /cost on CLI for real token/cost data".
• Agent resources (memory, dreams, files) ARE available and we can show them.
• This matches OpenClaw's /usage cost format but with the Claude Code limitation documented.
• This is the agent-aware equivalent of OpenClaw's /usage.