session-logs

Search and analyze JSONL session logs with jq and rg.

5|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/kcns008/clusterclaw --skill session-logs-kcns008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/kcns008/clusterclaw/tree/main/skills/session-logs
Command: npx skills add https://github.com/kcns008/clusterclaw --skill session-logs-kcns008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you search and analyze your stored session logs so you can recover earlier conversation context without manually digging through JSONL files.

Core Features & Use Cases

  • Historical lookup: Find what was said in older or parent conversations when the current chat does not include that context.
  • Session analysis: List sessions by date, measure message counts, summarize cost, and inspect assistant or user turns.
  • Keyword search: Search across one session or all sessions for specific phrases, then filter the relevant text with jq and rg.
  • Use case: A user asks, “What did we discuss about the cluster upgrade last week?” and the Skill quickly locates the session, extracts the relevant messages, and returns the answer.

Quick Start

Ask the assistant to search your session logs for a past topic and summarize the matching messages.

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 in JSONL session logs?

To search past conversation history, this Skill queries JSONL session logs using jq and rg to filter text, roles, timestamps, and costs, extracting matching messages from stored transcripts. It locates specific phrases across one or multiple sessions in seconds.

How do I find what was discussed in a parent conversation from an earlier chat?

Finding context from a parent conversation involves searching stored JSONL session logs to recover earlier chat context. The Skill filters historical references by keywords, retrieves relevant user and assistant turns, and returns the recovered context for the current chat.

Can I analyze session logs to measure message counts and summarize costs by date?

Analyzing session logs to measure message counts and summarize costs is supported by querying JSONL transcripts. The Skill lists sessions by date, inspects assistant or user turns, and extracts timestamp and cost data using jq and rg.

Do I need jq and rg installed to search JSONL transcripts for specific phrases?

Yes, jq and rg are required dependencies to search JSONL transcripts. The Skill relies on jq to parse JSONL files under the OpenClaw sessions directory and rg to perform cross-session keyword lookup and filter relevant text fields.

What's the best way to perform a cross-session keyword lookup in JSONL files?

The best way to perform cross-session keyword lookup in JSONL files is using this Skill, which applies rg for rapid text search across all stored JSONL transcripts and jq to filter the matching results by role, timestamp, or cost.

What are the limitations of using rg and jq for session log analysis?

A limitation of using rg and jq for session log analysis is that queries are restricted to text, roles, timestamps, and costs within the JSONL files under the OpenClaw sessions directory, meaning data outside these stored transcripts cannot be searched.