session-logs

Search and analyze past session transcripts in .jsonl files using jq and rg.

1|1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/qsimeon/openclaw-engaging --skill session-logs-qsimeon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/qsimeon/openclaw-engaging/tree/main/skills/session-logs
Command: npx skills add https://github.com/qsimeon/openclaw-engaging --skill session-logs-qsimeon

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 history stored in session log files, enabling you to recall previous discussions or context.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in .jsonl files.
  • Data Filtering: Use jq to filter messages by role, content type, or timestamp.
  • Cost Analysis: Calculate the total cost of a specific session or a daily summary.
  • Use Case: If a user asks about a decision made in a previous chat session, you can use this skill to quickly find and present that information.

Quick Start

Use the session-logs skill to search for the keyword "budget" in assistant responses within the session file named 'session-abc.jsonl'.

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 in JSONL session logs?

To search past conversation history, you can query session JSONL files using `jq` to filter by role or timestamp, and use `rg` for fast text searching within the message content.

Can I calculate the total token cost of a specific chat session?

Yes, you can calculate the total cost of a specific session by applying `jq` filters to extract and sum the cost metrics stored in your session JSONL transcript files.

Do I need jq and rg installed to analyze conversation transcripts?

Yes, you need both `jq` and `rg` installed locally; `jq` handles structured JSONL data filtering while `rg` performs rapid text searches across the session log files.

What is the best way to filter session log messages by role or content type?

The best way to filter session log messages by role or content type is using `jq` queries to parse the structured JSONL data and isolate specific historical conversation entries.

How do I recall a decision made in a previous chat session?

To recall a decision from a previous chat session, use `rg` to search for keywords within your session JSONL files, then apply `jq` to extract the matching conversation context.