session-logs

Search JSONL session logs with jq and rg to recover conversation context.

Updated Aug 13, 2025
One-click install
npx skills add https://github.com/JoeyJoziah/investment-analysis-platform --skill session-logs-joeyjoziah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/JoeyJoziah/investment-analysis-platform/tree/main/.claude/skills/session-logs
Command: npx skills add https://github.com/JoeyJoziah/investment-analysis-platform --skill session-logs-joeyjoziah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you recover details from older or parent conversations when the needed context is no longer in memory, making it easy to verify what was said before.

Core Features & Use Cases

  • Session Discovery: Locate session files by date, size, or keyword across your stored conversation history.
  • Transcript Analysis: Extract user, assistant, and tool-result messages from JSONL logs for review and summarization.
  • Usage Insights: Measure message counts, tool usage, and session cost to understand how a conversation evolved.
  • Use Case: If a user asks about an earlier discussion, use this Skill to find the relevant session and pull the exact messages that matter.

Quick Start

Ask the skill to find the session containing a specific phrase and summarize the relevant messages from that conversation.

Frequently Asked Questions about session-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search conversation history in JSONL session logs?

Search conversation history in JSONL session logs by applying jq and rg to filter messages and parse metadata across large files. This Skill recovers prior context by locating specific session files based on date, size, or keyword matches.

What is the best way to extract and analyze chat transcripts from stored sessions?

Analyze chat transcripts by extracting user, assistant, and tool-result messages from JSONL logs. This Skill enables transcript review and summarization by isolating specific message types from your stored conversation history.

Can I measure token usage and session costs from past conversations?

Measure session costs and token usage by parsing metadata within JSONL session files. This Skill inspects message counts and tool usage patterns to help you understand how a conversation evolved and its associated expenses.

Do I need jq and rg installed to search JSONL session files?

Yes, jq and rg are required dependencies to filter messages and parse metadata efficiently. These command-line tools enable the Skill to inspect large JSONL logs and perform keyword searches across your conversation history.

How do I find a specific phrase mentioned in an earlier conversation?

Find a specific phrase by requesting a keyword search across stored session logs. The Skill locates the session containing that phrase and pulls the exact messages that matter, summarizing the relevant context from that conversation.

What are the limitations of using jq and rg for session log analysis?

Using jq and rg for session log analysis is limited to filtering and parsing JSONL files where data is stored locally. This approach requires session files to be accessible on disk and does not query remote or cloud-stored conversation histories directly.