session-logs

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

1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Justicegaines03/OpenClaw_NIST-AI-RMF_Compliance --skill session-logs-justicegaines03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/Justicegaines03/OpenClaw_NIST-AI-RMF_Compliance/tree/main/skills/session-logs
Command: npx skills add https://github.com/Justicegaines03/OpenClaw_NIST-AI-RMF_Compliance --skill session-logs-justicegaines03

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, enabling you to retrieve information from older or parent conversations that are not readily available in current memory.

Core Features & Use Cases

  • Session Log Search: Query complete conversation histories stored in JSONL files.
  • Data Analysis: Utilize jq for powerful filtering and analysis of log data, including message content, timestamps, and costs.
  • Use Case: When a user asks about a decision made in a previous, unrelated chat session, you can use this skill to find that specific conversation and extract the relevant context.

Quick Start

Use the session-logs skill to search across all sessions 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 in JSONL files?

You can search conversation logs in JSONL files using jq for structured filtering and rg for keyword searches. This allows you to retrieve specific context from older or parent conversations that are not available in current memory.

Can I filter conversation history by date or message role using jq?

Yes, you can filter conversation history by date or message role using jq. The skill utilizes jq for powerful filtering and analysis of log data, allowing you to extract specific message roles and timestamps from your JSONL session files.

What do I need to analyze session costs from JSONL conversation logs?

You need jq and rg installed on your system to analyze session costs from JSONL logs. The skill uses jq to process the JSONL data and calculate the costs associated with each conversation session.

Does searching session logs with ripgrep work across all session files at once?

Yes, searching with ripgrep works across all session files at once. The skill supports performing keyword searches across all stored JSONL session files simultaneously to find relevant past conversations quickly.

When do I need to query JSONL conversation histories for context?

You need to query JSONL conversation histories when retrieving information about a decision made in a previous, unrelated chat session. Searching past logs enables you to find that specific conversation and extract the relevant context.

What are the limitations of using jq for conversation log analysis?

A limitation of using jq for conversation log analysis is that it strictly requires both jq and rg to be installed in the environment. The skill is designed exclusively for searching and analyzing JSONL files and cannot process other log formats.