session-logs

Locates and analyzes past session logs in JSONL transcripts using jq.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/rigeoben/fairy --skill session-logs-rigeoben
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/rigeoben/fairy/tree/main/skills/session-logs
Command: npx skills add https://github.com/rigeoben/fairy --skill session-logs-rigeoben

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Easily locate and extract context from your past conversations stored in session JSONL files, helping you understand prior decisions and user interactions.

Core Features & Use Cases

  • Fast search across all session logs to find references by date, user, or keyword.
  • Structured extraction of messages, timestamps, and roles to audit conversations.
  • Use cases include reviewing long-running chats, reconstructing reasoning chains, and auditing context for support scenarios.

Quick Start

Ask the AI to search your session history for a keyword or date to review prior conversations.

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 session logs for a specific keyword or date?▼

You can search past session logs by asking the AI to filter JSONL transcripts using jq parsing, which locates specific keywords, dates, or user roles to review prior conversations and interactions.

What is the best way to extract messages and timestamps from JSONL session transcripts?▼

Extracting messages and timestamps from JSONL session transcripts is done through jq parsing, enabling structured extraction of conversation roles and audit data to reconstruct reasoning chains or review long-running chats.

Can I filter JSONL session logs by user role or session ID?▼

Yes, you can filter JSONL session logs by session ID, date range, or user role using jq parsing, enabling targeted reviews of specific conversations and user interactions within your session history.

Does this session log analysis approach work for large JSONL files?▼

Yes, this approach supports large JSONL files by relying on standard Unix text processing for streaming and scalability, ensuring efficient jq parsing across extensive session transcripts without loading everything into memory.

When do I need to parse JSONL files with jq for session auditing?▼

You need to parse JSONL files with jq for session auditing when you want to locate past decisions, reconstruct reasoning chains, or audit context for support scenarios by structurally extracting messages, timestamps, and roles from stored conversations.