session-logs

Search and analyze JSONL session logs using jq and ripgrep.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/abhiunix/community-registry --skill session-logs-abhiunix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/abhiunix/community-registry/tree/main/skills/development/session-logs
Command: npx skills add https://github.com/abhiunix/community-registry --skill session-logs-abhiunix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable users to search and analyze their own session logs (older or parent conversations) stored as JSONL transcripts and leverage jq to derive insights.

Core Features & Use Cases

  • Search entire session histories by date, session, or message role to identify context and decisions.
  • Extract user messages, assistant responses, or tool usage from per-session JSONL logs for auditing and debugging.
  • Use cases include tracing conversation reasoning, verifying prompts, and recovering forgotten details.

Quick Start

Query the latest session to list all user 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 and extract past conversation messages from JSONL session logs?

To search JSONL session logs, you can query historical conversation transcripts using jq for structured JSON parsing and ripgrep for fast keyword searches to extract specific user or assistant messages.

Can I recover forgotten context and trace reasoning across multiple older sessions?

Yes, analyzing session logs allows you to recover forgotten context and trace conversation reasoning across multiple historical sessions by filtering JSONL transcripts by date, session ID, or message role.

What is the best way to audit tool usage and debug prompts from historical chat sessions?

The best way to audit tool usage and debug prompts is to parse JSONL session metadata and extract assistant responses or tool usage data using jq queries on your stored transcripts.

Do I need jq and ripgrep installed to analyze JSONL transcripts for conversation history?

Yes, you need jq for JSON parsing and ripgrep for keyword searches to effectively query and analyze your JSONL session logs and extract structured conversation data.

How do I query the latest session to list all user messages from JSONL logs?

You can list all user messages from the latest session by running a jq query against the designated sessions directory to filter JSONL transcripts for the user message role.

Can I extract session metadata and usage data from JSONL transcripts for debugging?

Yes, you can extract session metadata and usage data from JSONL transcripts by applying jq filters to parse the structured JSON records stored in your historical session logs.