session-reader

Name: session-reader
Availability: InStock
Author: v36372

Parse and summarize pi session JSONL logs for user interactions, tool usage, and subagent activity.

Updated Mar 6, 2026

Search Tags:#logs #analysis #subagents #session #jsonl #pi-agent

Ready to run

npx skills add https://github.com/v36372/pi-stuff --skill session-reader-v36372

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: session-reader
Source: https://github.com/v36372/pi-stuff/tree/main/skills/session-reader
Command: npx skills add https://github.com/v36372/pi-stuff --skill session-reader-v36372

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Efficiently read and analyze pi agent session JSONL files to quickly understand conversations, tool usage, and subagent activity.

Core Features & Use Cases

Parse session JSONL logs into human-friendly summaries and timelines.
View complete exchanges, tool invocations, and subagent results for debugging and auditing.
Filter, search, and drill into specific turns or exchanges for rapid investigation.

Quick Start

Pass a .jsonl session file to the reader to generate a readable summary and navigable report.

Frequently Asked Questions about session-reader

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

FAQPage Schema

How do I parse pi agent session JSONL logs to review conversations and tool usage?▼

To parse pi agent session JSONL logs, pass the .jsonl file to the session reader. It generates a human-friendly summary and navigable report detailing exchanges, tool invocations, and subagent activity.

What is the best way to debug subagent activity and costs from a pi session JSONL file?▼

The best way to debug subagent activity and costs from a pi session JSONL file is using a session reader. It surfaces structured data like exchanges, turns, costs, and subagent details for rapid investigation.

Can I analyze multiple session JSONL files across different projects in a batch?▼

Yes, you can analyze multiple session JSONL files across projects. The reader handles batch session collections, validating inputs and gracefully handling missing fields to surface interaction insights.

How does the session reader handle missing fields or malformed data in JSONL logs?▼

The session reader handles missing fields or malformed data in JSONL logs gracefully. It validates inputs during parsing to ensure the analysis of exchanges and tool invocations does not fail unexpectedly.

How do I filter and search for specific turns within a pi agent session log?▼

To filter and search for specific turns within a pi agent session log, use the session reader. It allows you to drill into specific turns or exchanges for rapid debugging and auditing of interactions.