session-logs

Analyze JSONL session logs with jq and ripgrep to locate past conversations.

1|Updated Mar 6, 2026

Search Tags:#logs #analysis #search #jq #jsonl #session-history

Ready to run

npx skills add https://github.com/zhcndoc/openclaw --skill session-logs-zhcndoc

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/zhcndoc/openclaw/tree/main/skills/session-logs
Command: npx skills add https://github.com/zhcndoc/openclaw --skill session-logs-zhcndoc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search and analyze your own session logs (older/parent conversations) using jq.

Core Features & Use Cases

Locate past conversations across sessions
Audit dialogue context and extract user messages from long histories
Support filtering, summarization, and quick verification of prior interactions with jq and ripgrep

Quick Start

Search your complete session history for a given query and return 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 session logs stored as JSONL files?▼

You can search past session logs by using jq and rg to query session history stored as JSONL files. This approach filters matching messages across sessions and formats outputs for human reading or downstream processing.

What is the best way to extract user messages from long conversation histories?▼

Extracting user messages from long conversation histories is done by applying jq filters to JSONL session logs. This isolates specific user inputs and dialogue context for auditing or summarization tasks.

Can I use jq and ripgrep to audit dialogue context across sessions?▼

Yes, you can audit dialogue context across sessions using jq and ripgrep. These tools operate on the state directory under agents with sessions/*.jsonl files to locate and verify prior interactions.

How does retrieving insights from session history work?▼

Retrieving insights from session history works by parsing JSONL files with jq to locate past conversations. It supports filtering, summarization, and quick verification of prior interactions formatted for downstream processing.

Do I need jq installed to analyze session logs?▼

Yes, you need jq installed as it is a core dependency for analyzing session logs. The process relies on jq and rg to query JSONL files and extract structured data from the state directory.