session-logs

Search and analyze past conversation logs in JSONL files using jq and rg.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fame0528/Savant-dead --skill session-logs-fame0528
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/fame0528/Savant-dead/tree/main/skills/session-logs
Command: npx skills add https://github.com/fame0528/Savant-dead --skill session-logs-fame0528

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, which is crucial when a user refers to older or parent conversations that are not currently in active memory.

Core Features & Use Cases

  • Session Log Search: Access and query historical conversation transcripts stored in JSONL files.
  • Context Retrieval: Useful for understanding previous interactions or information shared in earlier sessions.
  • Cost Analysis: Analyze the cost associated with past conversations.
  • Message Filtering: Extract specific types of messages (user, assistant, tool results) from logs.

Quick Start

Use the session-logs skill to search for sessions from a specific day.

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 logs to retrieve historical context?

You can search past conversation logs stored in JSONL files to retrieve historical context by using jq and rg to query and filter historical transcripts that are not in active memory.

How do I filter specific message types like user or assistant inputs from JSONL conversation logs?

Filtering specific message types from JSONL conversation logs is done by applying jq queries to extract user, assistant, or tool result messages from the stored session history.

Can I analyze the cost associated with past conversations using session history analysis?

Yes, you can analyze past conversation costs by querying the JSONL session logs with jq to extract and aggregate cost-related data from your historical transcripts.

Do I need jq and rg installed to search and analyze JSONL conversation transcripts?

Yes, you need jq and rg installed, as these command-line tools provide the core JSON parsing and text searching capabilities required to analyze JSONL conversation transcripts.

What is the best way to find keywords across all past conversation sessions?

The best way to find keywords across all past conversation sessions is using rg to perform fast text searches across multiple JSONL log files simultaneously.

How do I retrieve conversation transcripts from a specific date in JSONL session logs?

Retrieving conversation transcripts from a specific date involves using jq to filter JSONL session logs by date properties, allowing you to isolate interactions from that day.