# Session Stats

> Render a dashboard of the current Claude Code session — message counts, token usage, cache read/write, dollar cost, context %, lines changed, cost-per-turn sparkline, and a tool-call histogram — parsed from the session transcript JSONL by a bundled bash script. One bash call, zero analysis, zero confirmation. Optionally pass a session id to inspect a different session. Use when the user asks for session stats, usage, token or cost breakdown, or a session dashboard.

- Skill: `majiayu000/session-stats` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/session-stats`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/session-stats/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/session-stats

---


# Session-Stats

One bash call, then relay. The bundled script finds the transcript at
`~/.claude/projects/*/<session-id>.jsonl` (current id comes from
`CLAUDE_CODE_SESSION_ID` in the bash environment), aggregates it with `jq`,
and prints the dashboard. All numbers come from the script — compute nothing
yourself.

## Steps

1. Run — pass a session id only if the user named one, otherwise no args:

```bash
bash {base_directory}/dashboard.sh [session-id]
```

2. Print the script's stdout verbatim inside a ```text code fence. After the
   fence, add at most one sentence — or nothing.

3. Non-zero exit → print stderr verbatim and stop. No retries, no fallback
   parsing.

## Notes

- The transcript schema is internal to Claude Code; the script degrades to
  `—` for fields it can't find. Never "fill in" missing values by reading
  the JSONL yourself.
- For a colored render, the user can run the script directly:
  `! bash {base_directory}/dashboard.sh --color`

## You Must NOT

- Parse the JSONL or cost sidecar yourself, or run any git/jq command
- Summarize, interpret, reformat, or annotate the dashboard beyond one sentence
- Ask questions — this skill has no interactive path