session-logs

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

5.1k|1.2k|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/linuxhsj/openclaw-zero-token --skill session-logs-linuxhsj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/linuxhsj/openclaw-zero-token/tree/main/skills/session-logs
Command: npx skills add https://github.com/linuxhsj/openclaw-zero-token --skill session-logs-linuxhsj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg, and includes scripts (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 previous interactions or understand historical context.

Core Features & Use Cases

  • Session Log Search: Query historical conversation transcripts stored in JSONL files.
  • Data Analysis: Extract specific message types (user, assistant, toolResult), analyze costs, and count messages.
  • Use Case: If a user asks about a decision made in a previous chat session that is no longer in active memory, you can use this skill to find that session and retrieve the relevant information.

Quick Start

Use the session-logs skill to search for sessions containing 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 to recall historical context?

You can search past conversation logs by querying JSONL files with jq and rg to filter structured log data and retrieve previous chat information.

How do I extract specific message types from JSONL conversation history?

You can extract specific message types like user, assistant, and toolResult from JSONL conversation history by applying jq filters to parse the structured log data.

Do I need jq and rg installed to analyze session logs?

Yes, you need the jq and rg command-line tools installed, as they are required dependencies for efficiently filtering and searching structured conversation log data.

What is the best way to debug past interactions stored in JSONL files?

The best way to debug past interactions in JSONL files is using jq and rg to search session logs, analyze message costs, and audit historical conversation data.

Can I analyze token costs and count messages in conversation history?

Yes, you can analyze token costs and count messages in conversation history by running jq queries against the JSONL session log files to extract the relevant metrics.

What are the limitations of using jq for conversation analysis?

Using jq for conversation analysis limits you to querying static JSONL files, meaning you cannot interact with live sessions or retrieve data from logs not stored locally in this format.