# dm-usage

Bundled DM extension that adds `/usage`, an interactive dashboard for local session cost, token, provider, and model usage.

![Default table view of /usage](screenshot.png)

## Included command surface

- `/usage`

## Runtime notes

- Reads session JSONL files recursively from `~/.dm/agent/sessions/`.
- Respects `DM_CODING_AGENT_DIR`; `PI_CODING_AGENT_DIR` is accepted only as a compatibility fallback.
- Displays raw provider `openai-codex` as `duckmind-ultra` and `openrouter` as `duckmind-standard` without changing recorded session data.
- `Tab` / `←` / `→` switch periods, `v` toggles table/insights view, and `q` / `Esc` closes the dashboard.
- Cost data comes from recorded assistant usage payloads, so accuracy depends on providers reporting `usage.cost.total`.

## Bundled with dm

No separate install step is required. Install `dm`, then run `/usage` inside the TUI.
