# Model Usage

> Track and display LLM token usage, costs, and model statistics. Use when: user asks about token usage, API costs, how many messages were sent, or model performance stats. NOT for: changing the model or provider (use change_setting), or viewing conversation content (use session_logs).

- Skill: `ericwang915/model-usage` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add ericwang915/model-usage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ericwang915/model-usage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ericwang915 (https://skillmd.com/u/ericwang915)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ericwang915/model-usage

---


# Model Usage

Track and display LLM token usage, costs, and session statistics.

## When to Use

✅ **USE this skill when:**

- "How many tokens have I used?"
- "What's my API cost so far?"
- "Show me model usage stats"
- "How many messages in this session?"
- "Which model am I using?"

## When NOT to Use

❌ **DON'T use this skill when:**

- Changing the LLM model or provider → use `change_setting`
- Viewing conversation content → use `session_logs`
- Checking system status → check agent status directly

## Usage

### Current session stats

```bash
python {skill_path}/usage_stats.py
```

### Check detailed interaction log

The `history_detail.jsonl` file under `~/.pythonclaw/context/logs/` contains
structured records of every agent interaction, including:

- Input messages
- Tool calls and results
- LLM responses
- Timestamps

```bash
python {skill_path}/usage_stats.py --log ~/.pythonclaw/context/logs/history_detail.jsonl
```

### Quick stats via jq (if installed)

```bash
# Count total interactions
wc -l ~/.pythonclaw/context/logs/history_detail.jsonl

# Recent entries
tail -5 ~/.pythonclaw/context/logs/history_detail.jsonl | python -m json.tool
```

## Notes

- Token counts are estimates based on message length
- Cost calculation requires knowing the model's pricing (not tracked automatically)
- The `history_detail.jsonl` is append-only and grows over time
- Use `/status` command in chat for quick session info

## Resources

| File | Description |
|------|-------------|
| `usage_stats.py` | Parse and summarise usage from history logs |