session-logs

Parse JSONL session logs to extract messages by role with jq.

9|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/hongmaple0820/agent-academy --skill session-logs-hongmaple0820
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/hongmaple0820/agent-academy/tree/main/skills/tool-development/session-logs
Command: npx skills add https://github.com/hongmaple0820/agent-academy --skill session-logs-hongmaple0820

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locate and analyze older conversations stored in session logs to provide historical context for ongoing interactions.

Core Features & Use Cases

  • Search across all session logs (*.jsonl) to surface user messages, assistant responses, and tool usage.
  • Extract timestamps, session IDs, and message roles to understand conversation flow and cost.
  • Use cases include recalling prior decisions, validating memory integrity, and debugging memory gaps in conversations.

Quick Start

Search session logs for a keyword to retrieve relevant messages.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search session logs to find old conversations?

Search session logs by querying JSONL files with jq to locate older conversations. The skill parses session files and extracts user messages, assistant responses, and tool usage to surface relevant historical context.

What is the best way to extract timestamps and session IDs from conversation history?

Extract timestamps and session IDs from conversation history by parsing JSONL session files with jq. This mechanism isolates specific message roles and structural metadata to help you understand conversation flow and verify continuity.

How do I debug memory gaps in agent conversations?

Debug memory gaps in agent conversations by searching across all session logs to validate memory integrity. The skill traces prior decisions and extracts messages by role to identify missing context across sessions.

Can I analyze tool usage and cost from JSONL session files?

Analyze tool usage and cost from JSONL session files by extracting message roles and timestamps with jq. The skill surfaces tool interactions within the conversation history to help you understand usage patterns and expenses.

Does this session log search tool require any external dependencies?

This session log search tool requires no external dependencies to function. It uses jq to parse JSONL session files natively, allowing you to extract messages and trace conversation continuity without installing additional components.

When do I need to parse JSONL files for historical context?

Parse JSONL files for historical context when you need to recall prior decisions or verify conversation continuity across agent sessions. This process is necessary for validating memory integrity and debugging memory gaps in older interactions.