---
name: usage
description: View model usage statistics and session history
aliases: [stats]
invokes: skill:usage
---

# /usage Command

View usage statistics across Claude Code sessions.

## Usage

```
/usage                    # Summary (last 7 days)
/usage today              # Today's sessions
/usage week               # Last 7 days (default)
/usage month              # Last 30 days
/usage all                # All time
```

## Grouping

```
/usage --by agent         # Group by agent
/usage --by skill         # Group by skill
/usage --by model         # Group by model tier
```

## Configuration

```
/usage --set-level minimal|standard|detailed
/usage --show-config
```

## Log Levels

| Level | Data Captured |
|-------|---------------|
| `minimal` | Session ID, time, model |
| `standard` | + agents, skills, tokens (default) |
| `detailed` | + commands, delegations, errors |

## Example Output

```
📊 Usage Summary — Last 7 Days

Sessions: 12
Total time: 8h 32m
Model: opus (primary)

┌─────────────┬──────────┬────────┐
│ Agent       │ Sessions │ Time   │
├─────────────┼──────────┼────────┤
│ PA          │ 12       │ 8h 32m │
│ sysadmin    │ 4        │ 1h 15m │
└─────────────┴──────────┴────────┘
```

## Data Sources

- Session metadata from `~/.claude/state/personal-assistant/history/index.json`
- Configuration from `~/.claude/state/usage/config.json`
- Session content from `history/*.jsonl` (when available)