session-logs

Locate and analyze your own session logs in JSONL files.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/xcriminal1/Xcriminal-bot --skill session-logs-xcriminal1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/xcriminal1/Xcriminal-bot/tree/main/skills/session-logs
Command: npx skills add https://github.com/xcriminal1/Xcriminal-bot --skill session-logs-xcriminal1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you locate and analyze older or parent conversations stored in per-session JSONL files, enabling context retrieval beyond memory.

Core Features & Use Cases

  • Locate sessions by date, ID, or size to quickly retrieve relevant conversations.
  • Extract user and assistant messages from a single session for review or auditing.
  • Summarize and compare past discussions to provide context for current interactions.
  • Generate lightweight statistics (first/last timestamps, counts) to understand session history at a glance.

Quick Start

Run a search over your sessions JSONL files to locate and summarize messages from a chosen session.

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 past chat history in JSONL files, you need a tool that parses session logs, filters messages by role, and extracts user content to locate specific conversations. This skill applies those exact parsing and filtering functions to your stored interactions.

Can I compute message counts and time ranges from my session logs?

Yes, you can compute message counts and time ranges from session logs by analyzing the JSONL message data. The process extracts first and last timestamps to generate lightweight per-session statistics for your chat history.

What is the best way to extract user messages from a specific chat session for auditing?

The best way to extract user messages for auditing is to filter the JSONL session logs by role. This isolates user content from assistant responses, allowing you to review or audit interactions from a single session quickly.

How do I locate a specific conversation by date or ID when referencing older chats?

You can locate a specific conversation by date or ID by running a search over your session JSONL files. This filters your chat history by session metadata like date, ID, or size to retrieve the relevant past discussion.

Does this approach require any external dependencies to parse JSONL chat logs?

No external dependencies are required to parse JSONL chat logs. The skill operates independently to read your session files, extract the conversational context, and summarize past discussions without needing additional components.

What are the limitations of analyzing session logs stored as JSONL files?

A limitation of analyzing JSONL session logs is that context retrieval is restricted to the data physically stored within those files. You cannot parse interactions or sessions that were not saved in the JSONL format.