session-logs

Search and analyze past session conversations in JSONL files using jq and regex.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Retrieve and analyze your complete conversation history from stored session JSONL files efficiently.

Core Features & Use Cases

  • Search and Analyze Session Logs: Retrieve past conversations and gain insights from them using jq.
  • Keyword Search: Find specific conversations based on keywords or phrases.
  • Session Cost Tracking: Monitor the costs associated with each session.
  • Session Information Extraction: Extract user messages, assistant responses, and session details.

Quick Start

To search for a session from a specific date, use the 'session-logs skill' with the following command:

session-logs search --date <YYYY-MM-DD>

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

You can search conversation history in JSONL files by using jq to parse JSON data and regex for text search, retrieving past conversations for historical reference and analysis.

How do I track session costs from past conversations?

Session cost tracking is done by analyzing stored JSONL session logs to monitor the costs associated with each past conversation.

Do I need jq and rg to retrieve session logs?

Yes, retrieving and analyzing session logs requires jq for parsing JSON data and rg for regex text search to process stored JSONL files.

What is the best way to extract specific messages from session logs?

The best way to extract specific messages is using keyword search with regex on JSONL files, isolating user messages and assistant responses from past sessions.

Can I retrieve conversations from a specific date in JSONL session logs?

Yes, you can retrieve conversations from a specific date by running a search command against your stored JSONL session logs filtered by the target date.

What format do session logs need to be in for cost tracking and analysis?

Session logs must be stored as JSONL files to enable jq parsing, conversation retrieval, and accurate session cost tracking.