session-logs

Search and analyze past session logs in JSONL files using jq and rg.

3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/ybsa/sovereign-kernel --skill session-logs-ybsa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/ybsa/sovereign-kernel/tree/main/crates/sk-tools/skills/session-logs
Command: npx skills add https://github.com/ybsa/sovereign-kernel --skill session-logs-ybsa

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 a user refers to older or parent conversations that are not currently in active memory.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in JSONL files.
  • Historical Context Retrieval: Find information from previous interactions to maintain context and continuity.
  • Use Case: A user asks, "What did we decide about the Q2 budget last week?" This Skill can search through the session logs to find the relevant discussion and decision.

Quick Start

Use the session-logs skill to find sessions from a specific day.

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

You can search past conversation history by querying JSONL session logs using command-line tools. This Skill uses `jq` and `rg` to parse and retrieve specific historical discussion data from your saved transcripts.

How does session log analysis retrieve context from older conversations?

Session log analysis retrieves context by parsing JSONL conversation transcripts with `jq` and `rg`. It locates specific historical interactions and decisions, bringing older discussion context back into your current workflow.

Do I need jq and rg installed to search conversation logs?

Yes, you need `jq` and `rg` installed on your system. These command-line dependencies are strictly required to perform the JSONL parsing and text searching operations for past session logs.

What's the best way to find a decision from a previous chat session?

The best way to find a previous decision is to search your JSONL session logs. This Skill leverages `rg` for rapid text searching and `jq` for structured JSON querying to locate historical conversation context.

When do I need to parse historical conversation logs?

You need to parse historical conversation logs when a user references older or parent discussions that are no longer in active memory. It allows you to retrieve continuity and context from past interactions.

Can I use this approach to search conversation transcripts for any specific date?

Yes, you can search conversation transcripts for a specific date. By applying `jq` and `rg` to your JSONL session logs, you can filter historical chat data and extract interactions from the targeted timeframe.