session-logs

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg.

What problem does it solve?

This Skill allows you to search and analyze your past conversation history, which is crucial when a user refers to older or parent conversations that are not in the current memory.

Core Features & Use Cases

  • Search Session Logs: Access and query historical conversation transcripts stored in JSONL files.
  • Analyze Conversation Data: Extract specific information like user messages, assistant responses, costs, and tool usage from past sessions.
  • Use Case: If a user asks "What did we decide about the marketing budget last week?", you can use this skill to search through your session logs to find the relevant discussion and provide an accurate answer.

Quick Start

Use the session-logs skill to find all sessions from January 6th, 2026.

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

Search past conversation history in JSONL files using the jq command-line processor and ripgrep. This approach filters historical session logs to retrieve user queries, assistant responses, and cost data from previous agent sessions.

Can I extract assistant responses and cost data from previous agent sessions?

Yes, you can extract assistant responses and cost data from previous agent sessions by applying jq filters to your JSONL session logs. This allows precise retrieval of specific conversation transcripts and usage metrics.

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

Yes, you need both jq and ripgrep (rg) installed to analyze session logs. Jq processes the JSONL structure while ripgrep handles efficient text pattern matching within the log files.

What is the best way to retrieve historical context from older parent conversations?

The best way to retrieve historical context from older parent conversations is querying the stored JSONL session logs with jq. It directly parses the structured log data to find referenced discussions outside current memory.

How to find specific user messages from a certain date in conversation logs?

Find specific user messages from a certain date in conversation logs by running jq queries against the JSONL files. You can filter session transcripts by date ranges and extract the exact user queries and tool usage data needed.

Why use jq for searching agent session logs instead of standard text search?

Use jq for searching agent session logs because it parses the structured JSONL format accurately, unlike standard text search. Jq isolates specific JSON fields like cost data and tool usage that plain text matching cannot reliably extract.