session-reader

Parse pi session JSONL files into structured exchanges for analysis.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/peerasak-u/pi-config --skill session-reader-peerasak-u
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-reader
Source: https://github.com/peerasak-u/pi-config/tree/main/skills/session-reader
Command: npx skills add https://github.com/peerasak-u/pi-config --skill session-reader-peerasak-u

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Efficiently transform pi session JSONL files into readable, structured exchanges for quick analysis.

Core Features & Use Cases

  • Consolidated Exchanges: Convert user/assistant messages, tool results, and subagent details into coherent exchanges.
  • Multi-Mode Viewing: Supports toc, conversation, turn, overview, full, tools, costs, and subagents views for flexible inspection.
  • Search & Filter: Filter exchanges by keywords and range, with optional offset and limit controls.
  • Use Case: Audit a session to identify failures, review tool usage, and summarize agent performance across turns.

Quick Start

Run the read_session.py script on a session file to view a table of contents and drill into exchanges.

Frequently Asked Questions about session-reader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I parse JSONL session logs into readable exchanges?

Parse JSONL session logs into readable exchanges by running the read_session.py script, which converts user and assistant turns into a structured table of contents for quick review.

Can I filter session log exchanges by keyword or range?

Filter session log exchanges by keywords and range using optional offset and limit controls, allowing targeted inspection of specific user and assistant turns within the JSONL file.

What views are available for analyzing subagent runs and tool calls?

Analyze subagent runs and tool calls using multiple viewing modes including toc, conversation, turn, overview, full, tools, costs, and subagents views for flexible session inspection.

How do I audit agent performance and identify failures in a session?

Audit a session to identify failures, review tool usage, and summarize agent performance across turns by consolidating messages, tool results, and subagent details into coherent exchanges.

Does this tool require any dependencies to read pi session files?

No dependencies are required to read pi session files, as the standalone read_session.py script directly processes the JSONL format to output structured exchanges.