session-logs

Extract user and assistant messages from session JSONL files using jq and rg.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/augustscl/awesome-xiawang-skills --skill session-logs-augustscl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/augustscl/awesome-xiawang-skills/tree/main/session-logs-1.0.0
Command: npx skills add https://github.com/augustscl/awesome-xiawang-skills --skill session-logs-augustscl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables you to locate and analyze past conversations by querying session JSONL logs stored on disk, helping you recover context from prior chats.

Core Features & Use Cases

  • Search sessions by date, id, or user/assistant roles to retrieve relevant context.
  • Extract messages from a session for review, auditing, or summarization.
  • Analyze session metadata such as duration, and per-session costs if available in the logs.

Quick Start

Ask me to fetch the latest user message from a specific session by its ID.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search past session logs to recover context from prior chats?

Search session JSONL files by date, id, or user and assistant roles to retrieve relevant context and summarize conversation activity from past session transcripts.

Can I extract specific user and assistant messages from JSONL session transcripts?

Yes, you can extract specific user and assistant messages from JSONL session transcripts by filtering sessions by role, allowing you to review, audit, or summarize conversation activity.

What is the best way to analyze session metadata like duration and costs from JSONL logs?

The best way to analyze session metadata like duration and costs from JSONL logs is by using jq and rg to parse the JSONL data and produce human-readable results for conversation activity.

Does this session log search tool require any special dependencies to parse JSONL files?

Parsing JSONL session logs requires no external dependencies, as the Skill uses jq and rg internally to locate and retrieve insights from past session transcripts stored on disk.

How do I list session conversations by date to find a specific past chat?

You can list sessions by date to find a specific past chat by querying the session JSONL files stored on disk, which supports listing sessions by date to locate relevant context.