session-logs

Search and analyze JSONL conversation logs using jq and rg.

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

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

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in JSONL format.
  • Targeted Searching: Filter logs by date, keywords, or specific message roles (user, assistant).
  • Cost Analysis: Calculate the total cost incurred for specific sessions or daily summaries.
  • Use Case: If a user asks about a decision made in a previous conversation that isn't in the current short-term memory, you can use this skill to find that specific exchange and retrieve the relevant details.

Quick Start

Use the session-logs skill to search all sessions for the keyword "budget".

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?

To search past conversation logs stored in JSONL files, you can use this Skill to apply jq and rg command-line tools for efficient log parsing and pattern matching across your historical user-assistant interactions.

Can I filter conversation history by specific message roles or keywords?

Yes, you can filter conversation history by specific message roles, dates, or keywords. The Skill uses jq to query JSONL session logs, allowing targeted retrieval of user or assistant messages containing specific terms.

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

Yes, you need both jq and rg command-line tools installed to analyze session logs with this Skill. These dependencies are required for efficient JSONL log parsing and pattern matching during conversation history retrieval.

How can I calculate the total cost incurred for specific past sessions?

You can calculate the total cost incurred for specific sessions or daily summaries by using jq to parse and aggregate cost data fields within your JSONL conversation logs, providing historical usage and expense auditing.

What is the best way to debug past agent behavior from historical interactions?

The best way to debug past agent behavior is by searching and analyzing JSONL session logs. This Skill uses rg for pattern matching and jq for structured parsing to retrieve specific historical user-assistant interactions and review agent responses.

Why does the skill fail to retrieve historical context from my session logs?

If the skill fails to retrieve historical context from your session logs, ensure your conversation transcripts are stored in JSONL format and that the required jq and rg command-line tools are properly installed and accessible in your environment.