session-logs

Search and analyze JSONL conversation logs using jq and rg.

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

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 are stored in JSONL files, enabling you to retrieve historical context or information from older/parent conversations.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored locally.
  • Data Analysis: Utilize jq and rg to filter, extract, and summarize information from session logs.
  • Use Case: If a user asks about a decision made in a previous, unrelated chat session, you can use this skill to find that information and provide it.

Quick Start

Search all session logs 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 as JSONL files?

You can search past conversation logs by filtering and querying JSONL session data using `jq` and `rg`. This allows you to retrieve historical context or specific information from older or parent conversations.

How do I extract a specific decision made in a previous chat session?

To extract a specific decision from a previous chat session, search your local session logs using `rg` for the keyword and `jq` to filter the JSONL data. This retrieves the exact historical context from the stored transcripts.

Do I need jq and rg installed to analyze conversation history?

Yes, you need both `jq` and `rg` installed to analyze conversation history. They are required dependencies for filtering and searching the JSONL session data located in the `~/.openclaw/agents/<agentId>/sessions/` directory.

Can I query session logs to retrieve historical context for agents?

Yes, you can query session logs to retrieve historical context for agents. The skill directly accesses and queries local conversation transcripts, enabling agents to use information from older or parent conversations.

What is the best way to filter and summarize information from session logs?

The best way to filter and summarize information from session logs is by using `jq` and `rg`. These tools enable precise extraction and summarization of data directly from JSONL conversation transcripts.

Where are conversation transcripts stored for session log analysis?

Conversation transcripts are stored as JSONL files in the `~/.openclaw/agents/<agentId>/sessions/` directory. This local storage structure allows `jq` and `rg` to directly access and query the data.