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/MettaMazza/ErnOS --skill session-logs-mettamazza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/MettaMazza/ErnOS/tree/main/skills/session-logs
Command: npx skills add https://github.com/MettaMazza/ErnOS --skill session-logs-mettamazza

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 JSONL files, enabling you to recall previous discussions or context.

Core Features & Use Cases

  • Search Session History: Query full conversation transcripts stored in .jsonl files.
  • Analyze Costs: Calculate the total cost incurred for specific sessions or daily summaries.
  • Extract Specific Messages: Filter and retrieve user messages, assistant responses, or tool calls.
  • Use Case: If a user asks about a decision made in a previous, unrelated conversation, you can use this skill to find that conversation and extract the relevant details.

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 history stored in JSONL files?

You can search past conversation history stored in JSONL files by using the session-logs skill, which leverages the `jq` and `rg` command-line tools to query and retrieve historical context from your transcripts.

Can I analyze token costs from previous session logs?

Yes, you can analyze token costs from previous session logs. The skill processes JSONL files to calculate total costs incurred for specific sessions or generate daily usage summaries.

Do I need to install jq and rg to extract specific messages from session transcripts?

Yes, you need to install both `jq` and `rg`. These command-line tools are required dependencies for efficiently filtering and retrieving user messages, assistant responses, or tool calls from JSONL files.

What is the best way to find a decision made in an unrelated previous conversation?

The best way to find a past decision is to use the session-logs skill to search across multiple sessions for a specific phrase, extracting relevant details and historical context from your JSONL conversation logs.

How does searching conversation transcripts with jq and rg work?

Searching conversation transcripts works by using `rg` for fast text searching across JSONL files and `jq` for parsing JSON structure, allowing you to filter tool usage and extract specific messages across multiple sessions.