session-logs

Search and analyze JSONL conversation logs using jq and rg.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/StanH123h/clawdbot-self-use --skill session-logs-stanh123h
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/StanH123h/clawdbot-self-use/tree/main/skills/session-logs
Command: npx skills add https://github.com/StanH123h/clawdbot-self-use --skill session-logs-stanh123h

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 recall information from previous interactions or understand historical context.

Core Features & Use Cases

  • Search Session History: Query through jsonl files containing full conversation transcripts.
  • Analyze Costs: Calculate the total cost incurred for specific sessions or daily summaries.
  • Extract Specific Messages: Filter and retrieve messages from users or assistants within a session.
  • Use Case: If a user asks about a decision made in a previous chat session, you can use this skill to find that session and extract the relevant discussion.

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

To search past conversation logs stored in JSONL format, you can use tools like jq and rg to parse and retrieve historical user and assistant messages. This allows you to query full conversation transcripts and recall information from previous interactions.

Can I analyze token costs from historical chat sessions?

Yes, you can analyze token costs from historical chat sessions by parsing the JSONL log files. This process calculates the total cost incurred for specific sessions or generates daily cost summaries across multiple sessions.

Do I need jq and rg installed to extract specific messages from session history?

Yes, you need jq and rg installed to extract specific messages from session history. These command-line dependencies are required for parsing the JSONL files and searching through the session metadata and historical messages.

What is the best way to retrieve decisions made in previous chat sessions?

The best way to retrieve decisions made in previous chat sessions is to search and analyze your conversation logs. By filtering JSONL files, you can find the specific session and extract the relevant discussion or historical context.

Can I filter session metadata to find all conversations from a specific date?

Yes, you can filter session metadata to find all conversations from a specific date. By querying the JSONL log files, you can retrieve session history and extract transcripts matching specific chronological criteria.

What are the limitations when searching large volumes of conversation logs?

Limitations when searching large volumes of conversation logs depend on the performance of jq and rg parsing the JSONL files. The effectiveness of retrieving historical messages and session metadata is constrained by these command-line tools' search capabilities.