session-logs

Search and analyze JSONL conversation logs using jq and rg.

3|1|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/SeanHogg/coderClaw --skill session-logs-seanhogg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/SeanHogg/coderClaw/tree/main/product/skills/session-logs
Command: npx skills add https://github.com/SeanHogg/coderClaw --skill session-logs-seanhogg

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows you to search and analyze your past conversation logs, providing historical context that might not be readily available in current memory.

Core Features & Use Cases

  • Historical Context Retrieval: Access and query previous chat sessions to recall past discussions, decisions, or information.
  • Log Analysis: Utilize jq and rg to parse JSONL session files for specific messages, costs, or usage patterns.
  • Use Case: When a user refers to a previous discussion or asks for information from an older conversation, this skill can be used to find and present that historical data.

Quick Start

Use the session-logs skill to find all messages from a specific day in your session logs.

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 historical context?

To search past conversation logs, you can parse and retrieve historical context from JSONL session files. This allows you to recall past discussions, decisions, or information from older chats that are not in current memory.

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

Yes, you need jq and rg installed to analyze session history. These dependencies are required for parsing JSONL session files and searching for specific messages, costs, or usage patterns within the logs.

How do I retrieve messages from a specific day in JSONL session files?

You retrieve messages from a specific day by using jq and rg to parse JSONL session files. This enables targeted log analysis to find and present historical data based on your specific query parameters.

Where are conversation logs stored for agent session analysis?

Conversation logs for agent session analysis are stored as JSONL files in the ~/.coderclaw/agents/<agentId>/sessions/ directory. You can query this location to access previous chat sessions and retrieve historical context.

What is the best way to find usage patterns in past chat sessions?

The best way to find usage patterns in past chat sessions is by utilizing jq and rg to parse JSONL session files. This log analysis approach helps you extract specific messages, costs, and historical usage data efficiently.

Can I query previous chat sessions to recall past decisions?

Yes, you can query previous chat sessions to recall past decisions. By searching and analyzing JSONL conversation logs, you can retrieve historical context and information from older or parent conversations.