session-logs

Search and analyze JSONL conversation logs using jq and rg.

2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/FatBy/DD-OS --skill session-logs-fatby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/FatBy/DD-OS/tree/main/skills/session-logs
Command: npx skills add https://github.com/FatBy/DD-OS --skill session-logs-fatby

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 logs, which is crucial when needing 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.
  • Data Analysis: Utilize jq and rg to filter, extract, and summarize log data, including messages, costs, and tool usage.
  • Use Case: If a user asks about a decision made in a conversation from last week, you can use this skill to quickly find and present that information.

Quick Start

Use the session-logs skill to find all sessions from January 6th, 2026.

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 format?

To search past conversation logs in JSONL format, this Skill queries session directories to retrieve historical context, user messages, and assistant responses. It parses JSONL files directly to extract conversation history.

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

Yes, you need jq and rg installed to analyze session logs with this Skill. These command-line tools are required dependencies for filtering, extracting, and summarizing log data including messages, costs, and tool usage.

What is the best way to extract cost data and tool calls from chat history?

The best way to extract cost data and tool calls from chat history is using jq and rg to filter JSONL session logs. This approach allows you to summarize log data and retrieve specific usage metrics from past conversations.

Can I retrieve specific user messages and assistant responses from previous sessions?

Yes, you can retrieve specific user messages and assistant responses from previous sessions. The Skill searches conversation transcripts in JSONL format to recall information and understand historical context from past interactions.

What limitations exist when using rg and jq for conversation log analysis?

A limitation of using rg and jq for conversation log analysis is that it requires logs to be stored in JSONL format within specified session directories. Parsing fails if the log files are not properly formatted or the tools are not installed.