# Sessiondashboard

> Generate an interactive HTML dashboard of Claude Code session analytics Use when this capability is needed.

- Skill: `tomevault-io/sessiondashboard` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/sessiondashboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sessiondashboard/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/sessiondashboard

---


```mermaid
flowchart TD
    START(["/session:dashboard"]) --> DETECT["Detect repo"]
    DETECT --> EXTRACT["--phase extract (generates dashboard)"]:::phase
    EXTRACT --> CHECK["Check for dashboard.html"]:::phase
    CHECK --> OPEN{"Can open browser?"}
    OPEN -->|Yes| BROWSER["Open in browser"]:::done
    OPEN -->|No| PATH["Report file path"]:::done
    classDef phase fill:#2196F3,stroke:#333,color:white
    classDef done fill:#4CAF50,stroke:#333,color:white
```

> Follow this diagram as the workflow.

# Generate HTML Dashboard

Generate an interactive HTML dashboard visualizing Claude Code session analytics across PRs and issues.

## Workflow

### Step 1: Detect Repository

```bash
git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/' | sed 's/.*github.com[:/]\(.*\)/\1/'
```

### Step 2: Run the Extract Phase

The dashboard is generated as part of the extract phase:

```bash
python3 .claude/scripts/session-analytics.py \
  --phase extract \
  --repo <OWNER/NAME> \
  --output-dir /tmp/kagenti/session/
```

This generates all output files including the `dashboard.html`.

### Step 3: Verify the Dashboard

```bash
ls -la /tmp/kagenti/session/dashboard.html
```

### Step 4: Open in Browser

Attempt to open the dashboard in the default browser:

```bash
# macOS
open /tmp/kagenti/session/dashboard.html

# Linux
xdg-open /tmp/kagenti/session/dashboard.html 2>/dev/null || echo "Open manually: /tmp/kagenti/session/dashboard.html"
```

If the browser cannot be opened (e.g., headless environment), report the file path so the user can open it manually.

## Dashboard Contents

The HTML dashboard typically includes:
- Total sessions, tokens, and cost overview
- Token usage over time (line chart)
- Tool usage distribution (pie chart)
- Per-PR/issue breakdown table
- Session duration trends

## Parameters

| Parameter | Source | Required | Default |
|-----------|--------|----------|---------|
| `--phase` | Always `extract` | Yes | - |
| `--repo` | Auto-detected from git remote | Yes | - |
| `--output-dir` | Fixed | No | `/tmp/kagenti/session/` |
| `--from-date` | Optional date range start | No | 30 days ago |
| `--to-date` | Optional date range end | No | Today |

## Examples

```bash
# Generate dashboard for last 30 days
python3 .claude/scripts/session-analytics.py \
  --phase extract --repo kagenti/kagenti \
  --output-dir /tmp/kagenti/session/

# Generate and open
python3 .claude/scripts/session-analytics.py \
  --phase extract --repo kagenti/kagenti \
  --output-dir /tmp/kagenti/session/ && open /tmp/kagenti/session/dashboard.html
```

## Related Skills

- `session` - Router skill for all session analytics
- `session:post` - Post session stats to PR/issue comment
- `session:summary` - Update pinned summary comment
- `session:extract` - Extract analytics to CSV/MD/HTML

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/kagenti) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->