session-logs

Search and analyze historical JSONL session logs using jq and rg.

67|24|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/openxjarvis/openclaw-python --skill session-logs-openxjarvis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/openxjarvis/openclaw-python/tree/main/skills/session-logs
Command: npx skills add https://github.com/openxjarvis/openclaw-python --skill session-logs-openxjarvis

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 users refer to older or parent conversations that are not in the current memory.

Core Features & Use Cases

  • Session Log Access: Directly access and query historical conversation transcripts stored in .jsonl files.
  • Data Analysis: Utilize jq and rg to filter, extract, and summarize information from session logs, including user messages, assistant responses, costs, and tool usage.
  • Use Case: A user asks, "What did we decide about the Q3 marketing budget last week?" This Skill can search through the session logs to find the relevant discussion and decision.

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?

To search past conversation history stored in JSONL files, you can use command-line tools like jq and rg to filter, extract, and summarize session data. This allows you to retrieve specific context from older interactions that are no longer in active memory.

What is the best way to analyze historical session logs for past decisions?

The best way to analyze historical session logs for past decisions is by querying the JSONL transcripts with jq and rg. You can filter conversation content, user messages, and assistant responses to find relevant discussions and summarize the outcomes.

Do I need jq and rg installed to search JSONL session logs?

Yes, you need jq and rg installed and available in your system's PATH to search JSONL session logs. These command-line dependencies are required to perform the filtering, extraction, and summarization of the conversation data.

Can I extract tool usage and cost data from past conversation transcripts?

Yes, you can extract tool usage and cost data from past conversation transcripts. By utilizing jq to parse the JSONL format, you can query and summarize specific fields including costs, tool usage, and assistant responses from your historical sessions.

How to retrieve context from parent conversations not in current memory?

To retrieve context from parent conversations not in current memory, search the stored JSONL session logs. Using jq and rg, you can locate and extract the relevant historical interaction data to bring past context back into your current workflow.

Are there limitations when using command-line tools for session log analysis?

Limitations when using command-line tools for session log analysis include the requirement that jq and rg must be installed in the system PATH. Additionally, this approach relies entirely on the JSONL format for successful data extraction and retrieval.