session-logs

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows you to search and analyze past conversation logs, which is crucial when a user refers to older or parent conversations that are not in the current memory.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in JSONL files.
  • Historical Context Retrieval: Find information from previous interactions to maintain context and continuity.
  • Cost Analysis: Calculate the total cost of past sessions.
  • Message Filtering: Extract specific types of messages (user, assistant, tool results) from logs.
  • Use Case: A user asks, "What did we decide about the project timeline last week?" You can use this skill to search through past session logs to find the relevant discussion and decision.

Quick Start

Use the session-logs skill to search across all sessions for the phrase "project timeline".

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 for specific historical context?

To search past conversation logs, you can query JSONL files using jq and rg to retrieve historical context, user messages, and assistant responses from specific or all sessions within an agent directory.

Can I calculate the total cost of past sessions from JSONL logs?

Yes, you can perform cost analysis on past sessions by querying the conversation logs stored in JSONL files to calculate the total cost of your historical interactions.

Do I need jq and rg installed to analyze conversation history?

Yes, you need jq and rg installed on your system, as these command-line tools are required for parsing JSONL log files and performing pattern matching to search conversation history.

What is the best way to extract specific message types from session logs?

The best way to extract specific message types like user, assistant, or tool results from session logs is by filtering JSONL files using jq to parse the structured conversation data.

How does searching conversation history work when a user references older interactions?

Searching conversation history works by accessing and querying conversation transcripts stored in JSONL files, allowing you to retrieve information from previous interactions when current memory lacks the referenced context.

Can I search across all sessions within an agent directory simultaneously?

Yes, you can search across all sessions within a defined agent directory simultaneously, using rg for pattern matching and jq to parse the JSONL log files for the desired phrases or messages.