session-logs

Searches and analyzes session JSONL logs using jq and rg.

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

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 complete conversation history stored in session JSONL files, enabling you to recall past discussions or historical context.

Core Features & Use Cases

  • Session Search: Find specific conversations based on dates, keywords, or phrases across all logs.
  • Data Analysis: Extract user messages, assistant responses, tool usage, and calculate costs for individual sessions or daily summaries.
  • Use Case: If a user asks about a decision made in a previous, unrelated conversation, you can use this Skill to quickly locate and retrieve the relevant information from the session logs.

Quick Start

Use the session-logs skill to search 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 history stored in JSONL files?

To search past conversation history stored in JSONL files, you can use this Skill to query session logs with rg and jq. It retrieves historical user messages, assistant responses, and tool calls based on specific keywords or dates.

Can I extract and analyze tool usage and costs from session logs?

Yes, you can extract and analyze tool usage and costs from session logs. The Skill parses JSONL data with jq to calculate cost summaries and retrieve details for individual sessions or daily aggregated reports.

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

Yes, you need jq and rg installed to search and analyze JSONL session logs. These command-line tools are required dependencies for parsing structured JSON data and executing fast text searches across your conversation history.

What is the best way to retrieve context from a previous unrelated conversation?

The best way to retrieve context from a previous unrelated conversation is searching session logs by specific phrases or dates. This Skill locates historical discussions across all stored JSONL files to quickly recall past decisions.

What are the limitations when parsing JSONL conversation history with command-line tools?

A limitation when parsing JSONL conversation history with command-line tools is that functionality depends entirely on jq and rg availability. Parsing failures may occur if the JSONL structure is malformed or if logs are not stored in the expected format.

How does searching session logs compare to manually reading raw JSONL files?

Searching session logs with jq and rg provides targeted retrieval of user messages and cost summaries, whereas manually reading raw JSONL files requires visual scanning. This approach filters historical conversation data automatically by keywords.