session-logs

Index and search per-session JSONL files by date, role, and keywords.

1|Updated Jan 28, 2026

Search Tags:#analytics #logs #search #history #sessions #jq #jsonl

Ready to run

npx skills add https://github.com/Zentin-L/Masterbot --skill session-logs-zentin-l

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/Zentin-L/Masterbot/tree/main/skills/session-logs
Command: npx skills add https://github.com/Zentin-L/Masterbot --skill session-logs-zentin-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search and analyze your own session logs stored as per-session JSONL files to uncover context from older conversations and understand historical interactions.

Core Features & Use Cases

Search across all sessions by date, size, user messages, or keywords using jq and rg.
Extract user or assistant messages, count messages, and review per-session context for audit or debugging.
Use cases include reconstructing conversations referenced in a current chat, auditing history for compliance, and summarizing activity across sessions.

Quick Start

List all sessions by date and size from the sessions directory for quick overview.

Frequently Asked Questions about session-logs

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

FAQPage Schema

How do I search and analyze past chat history stored in JSONL files?▼

To search session history stored in JSONL files, this Skill indexes per-session logs to enable fast discovery of past context. It filters conversations by date, role, or keywords using jq and rg to extract matching messages.

Can I filter session logs by user or assistant role using jq?▼

Yes, you can filter session logs by user or assistant role using jq. The Skill extracts and isolates messages from specific roles within the JSONL files, allowing you to review individual contributions for auditing or debugging.

What is the best way to compute per-session metrics from JSONL history?▼

Computing per-session metrics from JSONL history involves applying jq to aggregate message counts and session sizes. This Skill processes the indexed sessions to summarize activity and calculate historical statistics.

Does this approach work for reconstructing conversations referenced in a current session?▼

Yes, it works for reconstructing older conversations referenced in a current session. By indexing sessions.json and individual JSONL logs, it retrieves and extracts past context to provide continuity for ongoing chats.

How do I list all past sessions by date and size for a quick overview?▼

Listing past sessions by date and size requires indexing the sessions directory. This Skill reads sessions.json to provide a quick overview of historical activity, showing when interactions occurred and their log file sizes.

Are there limitations when auditing large JSONL session histories?▼

Auditing large JSONL session histories depends on jq and rg processing capabilities. While the Skill enables fast discovery and filtering across all sessions, performance is constrained by the total volume of indexed log files.