session-logs

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

19|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill session-logs-samttoo22-mewcat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/samttoo22-MewCat/OpenSoul/tree/main/openclaw/skills/session-logs
Command: npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill session-logs-samttoo22-mewcat

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 useful when a user references older or parent conversations that are not in the current memory.

Core Features & Use Cases

  • Access Session Transcripts: Directly query conversation history stored in JSONL files.
  • Analyze Past Interactions: Understand historical context, user queries, and assistant responses from previous sessions.
  • Use Case: If a user asks "What did we discuss about the project last week?", you can use this skill to find and review those specific logs.

Quick Start

Use the session-logs skill to search for user messages containing the phrase "project status" in the session log file named 'session-abc123.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 logs stored in JSONL files?

To search conversation logs in JSONL files, you use command-line tools like jq and rg to query and retrieve historical user and assistant messages directly from the session transcripts.

Can I retrieve historical context from older parent conversations that are not in current memory?

Yes, you can retrieve historical context from older parent conversations by querying stored JSONL session log files to analyze past interactions and review previous user queries and assistant responses.

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

Yes, you need both jq and rg installed and accessible in your system's PATH to analyze session metadata and conversation history from the stored JSONL files.

What's the best way to extract specific user messages from session transcripts?

The best way to extract specific user messages from session transcripts is by using jq to filter JSONL files based on message content and roles, allowing precise targeting of historical user queries within the conversation logs.

Can I perform cost analysis on previous interactions using conversation logs?

Yes, you can perform cost analysis on previous interactions by querying session metadata stored within the JSONL conversation logs, allowing you to retrieve and calculate historical usage metrics from past sessions.

How does searching conversation history with jq handle large JSONL session files?

Searching conversation history with jq leverages the streaming JSONL format and combines it with rg for fast text searching, allowing efficient retrieval of session metadata and messages even from large conversation log files.