session-analyzer

Installation
SKILL.md

Session Analyzer

Overview

Use this skill when the job is "figure out what happened in Codex sessions for repo X and synthesize the next move" rather than doing open-ended manual log spelunking.

The default path is: run the bundled Python sync+digest script once, read its compact digest, then only inspect raw transcripts or repo artifacts if the digest is complete and still leaves an ambiguity.

Default time selection is the previous calendar date in the user's locale timezone. If the user instead asks for a rolling recent window such as "last 6 hours" or "past 12 hours", pass --last-hours N and let the script own the window math.

The script now does more than enumerate sessions:

  • inventories by target-day activity, not just thread creation day
  • assigns repo-match confidence (high, medium, low)
  • classifies each thread outcome heuristically (implemented_and_merged, plan_only, blocked_waiting_for_input, etc.)
  • separates target-day historical evidence from current repo state
  • emits ranked candidate_next_actions instead of forcing the final synthesis to start from a blank slate
  • emits theme_summaries that collapse many sessions into one workstream-level truth, including current state, superseded earlier sessions, and landed-vs-local-only counts
  • adds local-time timestamp fields alongside UTC so handoff reconstruction is easier in the user's timezone
  • reports current-branch divergence from main/upstream when --include-git is enabled
Installs
1
GitHub Stars
45
First Seen
Apr 5, 2026
session-analyzer — grp06/useful-codex-skills