session-read
SkillFiles & storageRead a past session and produce a structured summary (messages, tool calls, files, decisions)
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the session-read skill
What this skill tells your AI
The instructions your AI receives, as published by the-agency-ai/the-agency in .claude/skills/session-read/SKILL.md and read by ahel’s review.
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
-
Find the JSONL file matching the ID in
~/.claude/projects/. -
Read the file (use offset/limit for large files).
-
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
- 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
Signals
- GitHub stars
- 55
- Forks
- 8
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
session-read- Source
- github.com/the-agency-ai/the-agency