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

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 when needing to recall information from older or parent conversations that are not in the current memory.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in JSONL files.
  • Data Analysis: Utilize jq and rg to filter, search, and aggregate information from logs, including messages, costs, and tool usage.
  • Use Case: If a user asks about a decision made in a previous chat session, you can use this skill to find that session and extract the relevant discussion.

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

To search past conversation logs stored in JSONL files, you can query historical user and assistant messages using text search and JSON filtering tools. This process retrieves specific discussion transcripts from your agent session directories.

What's the best way to analyze previous chat session history for specific decisions?

The best way to analyze previous chat session history is to search and aggregate information from conversation transcripts using JSON query and text search tools. This allows you to extract relevant discussions and recall information from older parent conversations.

Do I need jq and rg installed to parse agent session logs?

Yes, you need jq and rg installed to parse agent session logs. These dependencies are strictly required for executing JSON parsing and text searching operations across the session directories to extract historical messages and metadata.

Can I extract cost analysis and tool usage breakdowns from session metadata?

Yes, you can extract cost analysis and tool usage breakdowns from session metadata. By filtering and aggregating the JSONL conversation logs, you can retrieve detailed historical usage metrics and associated session costs.

How does searching conversation transcripts with jq and rg work?

Searching conversation transcripts with jq and rg works by using rg for fast text searching across session directories and jq for structured JSON filtering. This combination enables precise retrieval of messages, metadata, and tool usage data from JSONL files.

Limitations of text search when retrieving historical messages from chat sessions?

A limitation of text search when retrieving historical messages is that it relies entirely on the structure of your JSONL files. If the session directories are not properly formatted or accessible, the parsing and filtering operations will fail to return results.