session-logs

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of not remembering what was said in older or parent conversations by letting you search your saved session transcripts quickly and precisely.

Core Features & Use Cases

  • Fast Historical Search: Locate relevant prior user and assistant messages across JSONL session logs using text search tools.
  • Conversation Mining & Summaries: List sessions by date and size, extract user messages, and compute per-session cost totals for review.
  • Cross-Session Phrase Discovery: Search for a phrase across all sessions to find where a topic was discussed, even if it is not in current context.

Quick Start

Ask this skill to search your session logs for a specific keyword or phrase and return the matching messages from the relevant session(s).

Frequently Asked Questions about session-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search conversation history in JSONL session logs?

To search conversation history in JSONL session logs, you can parse stored session files using command-line text search tools like jq and ripgrep. This allows you to quickly locate and extract relevant prior user and assistant messages across all saved transcripts.

What is the best way to find a specific phrase across past chat sessions?

Finding a specific phrase across past chat sessions involves running a cross-session text search using tools like ripgrep. This discovers where a topic was previously discussed by scanning all stored JSONL transcripts for exact keyword matches.

Can I calculate token cost analysis from saved JSONL chat logs?

Yes, you can perform cost analysis from saved JSONL chat logs by applying jq to parse session files and compute per-session cost totals. This deterministic extraction audits message costs and tool usage across historical conversations.

Do I need jq and ripgrep to extract messages from session logs?

Yes, you need jq and ripgrep installed to extract messages from session logs. These command-line tools are required to index JSONL files and retrieve message content deterministically when prior conversation context is needed.

How do I list past chat sessions by date and file size?

Listing past chat sessions by date and file size is done by applying jq to index stored JSONL session files. This summarizes your conversation history, allowing you to review and locate older parent conversations quickly.