session:dashboard

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

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:

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

This generates all output files including the dashboard.html.

Step 3: Verify the Dashboard

ls -la /tmp/rossoctl/session/dashboard.html

Step 4: Open in Browser

Attempt to open the dashboard in the default browser:

# macOS
open /tmp/rossoctl/session/dashboard.html

# Linux
xdg-open /tmp/rossoctl/session/dashboard.html 2>/dev/null || echo "Open manually: /tmp/rossoctl/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/rossoctl/session/
--from-date	Optional date range start	No	30 days ago
--to-date	Optional date range end	No	Today

Examples

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

# Generate and open
python3 .claude/scripts/session-analytics.py \
  --phase extract --repo rossoctl/rossoctl \
  --output-dir /tmp/rossoctl/session/ && open /tmp/rossoctl/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