---
description: Read a past session and produce a structured summary (messages, tool calls, files, decisions)
---

<!--
  Flag #62/#63: allowed-tools removed. Inherits Bash(*) from
  .claude/settings.json. Restricting to specific subcommand patterns at the
  skill level silently blocks agents on permission prompts the agent cannot
  see — see dispatch #171 for the devex incident that surfaced this trap.
-->

# Session Read

Extract a structured summary from a Claude Code session JSONL file.

## Arguments

`$ARGUMENTS` is a session ID (full UUID or partial prefix) or a session index from `/session-list`.

## Steps

1. **Find the JSONL file** matching the ID in `~/.claude/projects/`.

2. **Read the file** (use offset/limit for large files).

3. **Parse and extract** a structured summary:

### Session Metadata
- Session ID, date range, branch, directory

### User Messages (chronological)
- Timestamp and full content for each `type: "user"` line

### Tool Activity Summary
- Tool name and input summary (Bash commands, file paths, patterns, agent descriptions)
- Group consecutive tool calls

### Files Modified
- Unique file paths from Edit, Write, MultiEdit tool_use blocks

### Key Decisions
- Scan for "decided", "chose", "going with", "plan is", "approach:", "the fix is"

### Git Operations
- git commit messages, push/merge/rebase operations, branch changes

4. **Output** the summary in markdown format.

## Notes

- Large sessions may need chunked reading
- Focus on user messages and tool calls — skip thinking blocks and progress events