session-read
SkillFiles & storageRead a past session and produce a structured summary (messages, tool calls, files, decisions)
Use session-read in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add session-read and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the session-read skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
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
- 66
- Forks
- 12
- Last commit
- Sep 2026
Advanced
- Item type
- skill
- Key
session-read- Source
- github.com/the-agency-ai/the-agency
github.com/the-agency-ai/the-agency