session-logs

Search and analyze JSONL conversation logs using jq and rg.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/douglasjs/clawdbot_plugin_tools --skill session-logs-douglasjs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/douglasjs/clawdbot_plugin_tools/tree/main/session-logs
Command: npx skills add https://github.com/douglasjs/clawdbot_plugin_tools --skill session-logs-douglasjs

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, which is crucial when users refer to older or parent conversations that are not currently in memory.

Core Features & Use Cases

  • Search Session Logs: Access and query historical conversation data stored in JSONL files.
  • Analyze Conversation History: Understand past interactions, identify previous requests, or recall information from earlier in the dialogue.
  • Use Case: A user asks, "What did we decide about the project timeline last week?" This Skill can be used to search through session logs to find the relevant discussion and decision.

Quick Start

Use the session-logs skill to find all user messages containing the keyword "budget" in 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 logs for specific keywords?

You can search past conversation logs by using `rg` to find specific keywords across your JSONL session files. This allows you to quickly retrieve messages containing the exact terms you are looking for.

How do I analyze conversation history stored in JSONL files?

You analyze conversation history in JSONL files by filtering the structured data with `jq`. This enables you to parse past interactions, identify previous requests, and recall information from earlier dialogues.

Do I need jq and rg installed to search session logs?

Yes, you need both `jq` and `rg` installed. The Skill relies on `rg` for keyword searching across conversation histories and `jq` for filtering and querying the JSONL log data.

Can I retrieve specific messages from older conversations not in memory?

Yes, retrieving specific messages from older conversations is the core function of this tool. It searches historical session logs to find relevant discussions and decisions from past interactions that are no longer in memory.

What is the best way to find previous decisions in conversation history?

The best way to find previous decisions is to search session logs using this tool. It queries your stored JSONL conversation data to locate the relevant discussion and extract the decision made during that past dialogue.

Can I perform cost analysis on past conversation logs?

Yes, you can perform cost analysis on past conversation logs. By filtering the JSONL session files with `jq`, you can extract and calculate usage metrics and costs across your entire conversation history.