session-logs

Search and analyze JSONL conversation logs using jq and rg.

12|3|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ApiliumCode/mayros --skill session-logs-apiliumcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/ApiliumCode/mayros/tree/main/skills/session-logs
Command: npx skills add https://github.com/ApiliumCode/mayros --skill session-logs-apiliumcode

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 logs, which is crucial for recalling information from previous interactions or understanding historical context.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in JSONL format.
  • Data Analysis: Utilize jq to filter, extract, and summarize specific information like user messages, assistant responses, costs, and tool usage.
  • 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 across all sessions for the phrase "project deadline".

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 find specific information from a previous session?

To search past conversation logs, you can query JSONL session files using the `jq` and `rg` command-line tools to filter and extract historical user messages, assistant responses, and tool usage data.

Do I need to install jq and rg to analyze JSONL conversation history?

Yes, you need to install both `jq` and `rg` because they are required dependencies for parsing and searching the JSONL conversation log files to retrieve past interactions and cost data.

What is the best way to extract past assistant responses and cost data from JSONL transcripts?

The best way to extract past assistant responses and cost data from JSONL transcripts is by applying `jq` filters to parse the structured conversation logs stored in your specified session directories.

Can I retrieve tool usage history from previous chat sessions using command-line tools?

Yes, you can retrieve tool usage history from previous chat sessions by running command-line searches with `rg` and `jq` against the JSONL formatted session logs stored in your local directories.

What type of data format is required for searching past chat history with command-line tools?

The data format required for searching past chat history is JSONL, which stores conversation transcripts locally and allows `jq` and `rg` to query user messages and assistant responses efficiently.

Are there limitations when analyzing session logs with jq and rg?

A limitation when analyzing session logs is that this approach only works for conversations exported or stored locally in JSONL format within accessible directories, requiring `jq` and `rg` to be installed.