skills.rest
tedtv1007-ctrl
tedtv1007-ctrlCOMMUNITY
Explore all skills by this author →
GitHub

session-logs

Search and analyze local JSONL conversation history files with jq and ripgrep.

Updated Mar 26, 2026
Search Tags:#logs#analysis#search#history#jq#ripgrep
One-click install
npx skills add https://github.com/tedtv1007-ctrl/milk-skills-library --skill session-logs-tedtv1007-ctrl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/tedtv1007-ctrl/milk-skills-library/tree/main/session-logs
Command: npx skills add https://github.com/tedtv1007-ctrl/milk-skills-library --skill session-logs-tedtv1007-ctrl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, ripgrep.

What problem does it solve?

This skill solves the difficulty of retrieving specific information or context from past conversations that are no longer present in the active memory.

Core Features & Use Cases

  • Historical Search: Quickly find specific keywords or phrases across all your past session transcripts.
  • Usage Analytics: Calculate total costs, message counts, and tool usage patterns across your session history.
  • Use Case: If you need to recall a specific technical decision or a piece of code discussed in a conversation from last week, this skill allows you to query your local JSONL logs to find the exact message.

Quick Start

Use the session-logs skill to search for the keyword project-alpha in all my past conversation files.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search historical chat logs for a specific keyword?▼

Searching historical chat logs is done by querying local JSONL conversation history files with ripgrep and jq. This skill parses and filters structured log data to retrieve specific keywords, technical decisions, or code discussed in past sessions.

Can I calculate total costs and message counts from past agent sessions?▼

Yes, you can calculate total costs and message counts from agent sessions. This skill analyzes local JSONL chat logs to perform usage analytics, tracking message volumes, token costs, and tool usage patterns across your session history.

Do I need jq and ripgrep installed to analyze JSONL conversation history?▼

Yes, you need jq and ripgrep installed to analyze JSONL conversation history. These command-line dependencies are required by this skill to efficiently parse and filter the structured log data stored in your local files.

What is the best way to retrieve context from a conversation no longer in active memory?▼

The best way to retrieve context not in active memory is to search your local JSONL files. This skill uses command-line utilities to find exact messages and recall past technical decisions from your session transcripts.

Does session-logs work with live agent memory or only local JSONL files?▼

session-logs works only with local JSONL files, not live agent memory. It applies to historical context retrieval, cost tracking, and message auditing by parsing structured log data from past conversations stored locally on your machine.

Related Skills

Explore More Data & Analytics Skills→
aresbitaresbit
46

session-logs

Search and analyze historical session JSONL files using jq and rg.

Community
Intermediate
Deskaunedsei1983Deskaunedsei1983

session-logs

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

Community
Intermediate
SaturateSaturate

stats

Compute Claude Code usage totals, per-tool counts, and session counts from JSONL logs.

Community
Intermediate
pablomat555pablomat555
1

session-logs

Search and analyze session JSONL files with jq and rg.

Community
Intermediate