skills.rest
v36372
v36372COMMUNITY
Explore all skills by this author →
GitHub

session-reader

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
One-click install
npx skills add https://github.com/v36372/pi-stuff --skill session-reader-v36372
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Data & Analytics Skills→
Dolonia333Dolonia333

session-logs

Locate and analyze historical session data in JSONL files using jq and rg pipelines.

Community
Intermediate
ZzulinZzulin
8

unity-perception

Generate structured Unity scene summaries and markdown dependency reports.

Community
Advanced
laitim2001laitim2001

claude-agent-sdk

Orchestrate autonomous Claude agents with MCP tools and safety hooks.

Community
Advanced
vladolaruvladolaru
6

analyzing-cc-sessions

Parse JSONL transcripts to extract metrics and diagnose subagent behavior.

Community
Advanced