session-logs

Search and analyze JSONL session histories using jq and rg.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users locate and analyze past conversations stored in session logs to provide context, auditing, and reference for current queries.

Core Features & Use Cases

  • Search and filter complete session transcripts stored as JSONL to surface relevant user or assistant messages.
  • Compute per-session statistics (message counts, time ranges) and extract historical context to inform current decisions.
  • Use Case: When a user asks about something said earlier, pull the exact user and assistant messages from the relevant session to refresh memory.

Quick Start

Provide a session ID and ask it to extract the user messages from that session.

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

You can search past conversations stored in JSONL session logs by applying jq and rg to parse, filter, and surface relevant user or assistant messages from your complete session histories.

How do I extract user messages from a specific session ID?

To extract user messages from a specific session ID, provide the session ID to the Skill and it will parse the JSONL files to pull exact user and assistant messages from that historical session.

Can I compute message counts and time ranges from session histories?

Yes, you can compute per-session statistics like message counts and time ranges from session histories to extract historical context and inform current decisions.

Do I need jq and rg to analyze JSONL session transcripts?

Yes, you need jq and rg to analyze JSONL session transcripts, as these tools are used to parse, filter, and summarize messages, user content, and tool usage from historical data.

Where are my session histories stored for analyzing past chats?

Your session histories are stored as JSONL files in the ~/.openclaw/agents/<agentId>/sessions/ directory, allowing you to audit chats and recall prior context across sessions.