session-logs

Search and analyze JSONL conversation logs using jq and rg.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg, and includes 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 previous discussions or context.

Core Features & Use Cases

  • Session Search: Quickly find information from older or parent conversations.
  • Log Analysis: Utilize jq for powerful querying of JSONL log files.
  • Use Case: If a user asks about a decision made in a previous chat session that isn't in current memory, you can use this skill to find that information.

Quick Start

Use the session-logs skill to search across all sessions for the phrase "project deadline".

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 context from previous sessions?

You can search past conversation logs for specific context by querying JSONL session files with jq and rg to retrieve historical user messages and assistant responses. This allows you to recall decisions or discussions from older chats not in current memory.

Can I extract cost data and user messages from JSONL session history?

Yes, you can extract cost data and user messages from JSONL session history by running jq queries against the session log files. This facilitates detailed log analysis of historical context and token costs across specific or all sessions.

Do I need jq and rg installed to analyze session log files?

Yes, you need jq and rg installed and accessible in your system's PATH to analyze session log files. These command-line tools are required for parsing the JSONL format and performing keyword searches across the logs.

What is the best way to find a decision made in a previous chat session?

The best way to find a decision made in a previous chat session is to search across all session logs for the relevant phrase. Using rg for keyword searching and jq for structured querying quickly retrieves the historical context.

How does querying JSONL conversation history with jq work?

Querying JSONL conversation history with jq works by applying structured filters to extract specific fields like user messages, assistant responses, and cost data from line-delimited JSON records. This mechanism enables precise retrieval of historical context.

Can I search all session files at once or am I limited to a specific session log?

You can search all session files at once or target a specific session log. The skill facilitates retrieval of historical context from either specific or all session files using rg and jq.