myinsights

myinsights

The built-in /insights samples a subset of sessions and reflects the currently-logged-in view. This produces a report over the whole local corpus, merged across every login, because /login overwrites only identity (keychain token + ~/.claude.json), never ~/.claude/projects/** or ~/.claude/usage-data/** — all logins' sessions already coexist locally.

Honesty guardrails (must survive into the report):

• Sessions on disk carry no account tag → the report is merged, it cannot split work vs personal. State this.
• Quantitative stats cover all session-meta; the qualitative narrative is grounded in the available facets (a subset). Don't imply the narrative saw every session.

Steps

1. Extract substrate (deterministic, read-only) into a scratch dir:

   OUT=/tmp/myinsights && python3 "${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}/skills/myinsights/gather_all.py" "$OUT"
   

   Writes $OUT/quant.json (rollups: sessions, tokens, commits/pushes, durations, top tools, languages, error categories, by-hour, project areas) and $OUT/facets_compact.json (trimmed qualitative facets). Honours CLAUDE_CONFIG_DIR.

2. Synthesize the narrative — read $OUT/facets_compact.json + $OUT/quant.json and produce a JSON object at full /insights depth (a deep Opus agent, effort high). Ground every claim in the data; cite counts; full-corpus claims use n=sessions framing, sampled claims use n=facets; say "insufficient data" rather than invent. Save to $OUT/narrative.json. Exact schema (the renderer degrades gracefully if a block is missing, but aim for all of it):

   headline: str
   project_areas: [{name, session_count:int, description}]            # 5-6
   interaction_style: {narrative, key_pattern}
   what_works: {intro, impressive_workflows:[{title, description}]}    # 3
   friction: {intro, categories:[{category, description, examples:[]}]} # 3, examples paraphrased from facets
   suggestions: {
     claude_md_additions:[{addition, why, prompt_scaffold}],           # 5  (prompt_scaffold = short "Add under a ## X section" hint)
     features_to_try:[{feature, one_liner, why_for_you, example_code}], # 3
     usage_patterns:[{title, suggestion, detail, copyable_prompt}]     # 3  (detail = 2-3 sentence grounded paragraph)
   }
   on_the_horizon: {intro, opportunities:[{title, whats_possible, how_to_try, copyable_prompt}]}  # 3
   fun_ending: {headline, detail}
   at_a_glance: {whats_working, whats_hindering, quick_wins, ambitious_workflows}