session-logs

Search and analyze JSONL session logs using jq and rg.

1|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/lachlanchen/LazyingArtBot --skill session-logs-lachlanchen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/lachlanchen/LazyingArtBot/tree/main/skills/session-logs
Command: npx skills add https://github.com/lachlanchen/LazyingArtBot --skill session-logs-lachlanchen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to search and analyze your past conversation history stored in session log files, enabling you to recall previous discussions or context.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in JSONL format.
  • Data Analysis: Utilize jq and rg to filter, extract, and summarize information from historical logs.
  • Use Case: If a user asks about a decision made in a previous, unrelated chat session, you can use this Skill to quickly find that information within the session logs.

Quick Start

Use the session-logs skill to search for all assistant messages containing the word "budget" in the session file named 'session-abc.jsonl'.

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 conversation transcripts stored in JSONL session logs?

You can search past conversation transcripts in JSONL session logs by using command-line tools like jq and rg to filter, extract, and summarize historical user and assistant messages. This allows you to quickly recall previous discussions or context.

Can I analyze token cost and tool usage from historical agent session data?

Yes, you can analyze historical agent session data to retrieve cost analysis and tool usage breakdowns. By querying the JSONL session logs with jq, you can extract and summarize specific usage metrics from your past conversations.

Do I need jq and ripgrep installed to query conversation history?

Yes, you need both jq and ripgrep (rg) installed and available in your system's PATH to use this session log search functionality. These command-line tools are required to filter and extract data from the JSONL transcript files.

What's the best way to find a specific decision made in a previous chat session?

The best way to find a specific decision from a previous chat is to search your session log files using rg for keywords or jq for structured JSONL filtering. This retrieves the historical user and assistant messages containing the relevant context.

How do I extract all assistant messages containing a specific keyword from session logs?

You can extract assistant messages containing a specific keyword by running jq and rg commands against your JSONL session log files. This filters the conversation transcripts to retrieve only the matching historical messages from the specified session.