session-logs

Search and analyze conversation history in JSONL files using jq.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/breakingcircuits1337/agent-skills --skill session-logs-breakingcircuits1337
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/breakingcircuits1337/agent-skills/tree/main/session-logs
Command: npx skills add https://github.com/breakingcircuits1337/agent-skills --skill session-logs-breakingcircuits1337

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies the process of searching and analyzing your conversation history stored in session log files, providing a fast and efficient way to recall past interactions.

Core Features & Use Cases

  • Session Search: Quick search across all sessions for specific keywords or phrases.
  • Session Indexing: Provides an index of sessions by date and size for easy navigation.
  • Data Extraction: Extract user messages, assistant responses, and tool usage details from individual sessions.
  • Use Case: Use this Skill to find a specific conversation from a few months ago or analyze the cost and performance metrics of a session.

Quick Start

Analyze the conversation history from a specific date using the session-logs skill and the date '2023-03-15'.

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 stored in JSONL files?

To search conversation history in JSONL files, you can parse the logs to quickly find specific keywords or phrases across all past sessions. This allows you to easily recall and retrieve relevant interaction data.

How do I extract user messages and assistant responses from session logs?

Extracting user messages and assistant responses from session logs involves parsing the JSONL data structure. This separates individual interactions, allowing you to pull specific communication details and tool usage metrics from your sessions.

Do I need jq to analyze JSONL session logs?

Yes, you need jq installed to analyze JSONL session logs. The Skill requires jq for parsing the JSONL files to retrieve past interactions and extract relevant communication data effectively.

What is the best way to index conversation history by date and size?

The best way to index conversation history by date and size is to use a parsing tool to organize your JSONL session logs. This provides an easy navigation structure for auditing and analyzing past interactions.

Can I analyze the cost and performance metrics of a specific JSONL session?

Yes, you can analyze the cost and performance metrics of a specific JSONL session. By parsing the conversation history, you can extract tool usage details and performance data for individual interactions on a given date.

Why use jq for parsing conversation history instead of other data analysis tools?

Using jq for parsing conversation history is effective because it directly processes JSONL files, enabling fast extraction of user messages and assistant responses. It is specifically required to query and retrieve data from these structured logs.