session-logs

Search and analyze past conversation logs in JSONL files using jq and rg.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg.

What problem does it solve?

This Skill allows you to search and analyze your past conversation logs, which are stored in JSONL files, enabling you to recall previous discussions or context.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in ~/.mrhammadclaw/agents/<agentId>/sessions/.
  • Data Analysis: Utilize jq and rg to filter, sort, and extract specific information like messages, costs, or tool usage from session files.
  • Use Case: When a user asks about a decision made in a previous, unrelated conversation, you can use this skill to quickly find and present the relevant historical context.

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 files?

You can search past conversation logs stored in JSONL files by using command-line tools like jq and rg to filter, sort, and extract specific messages or historical context from your stored session transcripts.

Do I need jq and rg installed to analyze session history?

Yes, you need jq and rg installed to analyze session history. These command-line tools are required dependencies for parsing and searching the JSONL data structures that store your conversation logs.

What is the best way to retrieve context from a previous chat session?

The best way to retrieve context from a previous chat session is to query the JSONL files directly stored in your agents directory, using jq to extract specific data like messages, costs, or tool usage from the history.

Can I extract tool usage and cost data from conversation logs?

Yes, you can extract tool usage and cost data from conversation logs. By utilizing jq to filter the JSONL session files, you can isolate and analyze specific interaction patterns or metrics from your past conversations.

How does analyzing conversation patterns in JSONL transcripts work?

Analyzing conversation patterns in JSONL transcripts works by applying jq filters and rg searches to the raw session data, enabling you to audit past interactions and recall specific decisions made across unrelated conversations.