/insights: add project-level and date-range filtering

Resolved 💬 3 comments Opened Mar 2, 2026 by austinarterburn Closed Mar 6, 2026

Problem

/insights aggregates ALL sessions across all project directories, mixing work and personal usage into a single report. This makes the report unsuitable for sharing in a professional context.

Current behavior

Running /insights in any project directory produces a single report combining sessions from all project_path values in ~/.claude/usage-data/session-meta/. For example, my Azure infrastructure work (C:\repos) and homelab debugging sessions (D:\personal\repos) are combined into one report.

Requested behavior

Add filtering flags to scope the report:

# Filter by project directory (prefix match)
/insights --project C:\repos

# Exclude specific projects
/insights --exclude D:\personal

# Date range
/insights --since 2026-02-15 --until 2026-03-01

Why this matters

  • Shareability: Work reports shouldn't include personal homelab debugging sessions
  • Accuracy: Mixed-context reports dilute the analysis — friction patterns, tool usage, and project areas are muddled
  • Weekly reviews: Running filtered reports on a cadence (weekly, per-sprint) is useful for team retrospectives

The data already supports this

Each session-meta/*.json already contains project_path and start_time fields. The filtering would only need to happen at the session-selection step before facet analysis begins.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗