session-logs

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

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/sky770825/openclaw-console-hub --skill session-logs-sky770825
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/sky770825/openclaw-console-hub/tree/main/openclaw-main/skills/session-logs
Command: npx skills add https://github.com/sky770825/openclaw-console-hub --skill session-logs-sky770825

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows you to search and analyze your complete conversation history stored in session JSONL files, enabling you to recall past discussions or context.

Core Features & Use Cases

  • Search Session History: Find specific information from older or parent conversations.
  • Analyze Transcripts: Use jq and rg to query message content, costs, and usage.
  • Use Case: When a user refers to a previous discussion or asks for historical context not present in current memory, this skill can retrieve and analyze that information.

Quick Start

Use the session-logs skill to find user messages containing the keyword "budget" in the session file named "session-abc.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 history stored in JSONL session logs?

To search past conversation history, you can parse JSONL session transcripts using the `jq` and `rg` command-line tools to extract and retrieve specific historical context, user messages, and assistant responses.

Can I analyze token usage and cost data from agent session transcripts?

Yes, you can analyze token usage and cost data from agent session transcripts by applying `jq` queries to parse the structured JSONL log files and calculate the associated expenses.

Do I need to install jq and rg to extract text from conversation JSONL files?

Yes, you need to install both `jq` and `rg` because the skill requires these command-line tools to parse structured log data and execute pattern matching on the conversation JSONL files.

What is the best way to retrieve historical context from older parent conversations?

The best way to retrieve historical context from older parent conversations is to search the stored JSONL session transcripts with `rg` for pattern matching and `jq` to extract the relevant message payloads.

How does searching session transcripts with jq and rg work for retrieving specific user messages?

Searching session transcripts with `jq` and `rg` works by using `rg` to rapidly locate keyword matches across raw JSONL files and `jq` to parse the matching JSON objects into readable message content.

What are the limitations of analyzing conversation history directly from JSONL files?

A limitation of analyzing conversation history from JSONL files is that you are restricted to querying static transcript data, meaning you cannot interact with the live session or modify the historical agent responses.