session-logs

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg, and includes scripts (resource) components.

What problem does it solve?

This skill allows you to search and analyze your past conversation logs, which are stored in JSONL files, enabling you to recall or reference information from older or parent conversations.

Core Features & Use Cases

  • Search Conversation History: Quickly find specific messages or information within your complete chat history.
  • Analyze Session Data: Examine message content, timestamps, roles (user/assistant), and even cost data per session.
  • Use Case: If a user asks about a decision made in a previous, unrelated chat session, you can use this skill to locate that information and provide context.

Quick Start

Use the session-logs skill to search across all sessions for the phrase "project deadline".

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?

To search past conversation history stored in JSONL files, you can use the session-logs skill to locate specific messages, user inputs, and assistant responses. It leverages `jq` and `rg` to filter and retrieve historical context from your chat logs.

Can I extract cost data and timestamps from previous chat session logs?

Yes, you can analyze session data to extract cost data, timestamps, and message roles from your previous chat session logs. The skill processes JSONL files to examine specific conversation metrics and historical cost summaries.

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

Yes, you need both `jq` and `rg` installed to search conversation logs with this skill. These dependencies are required for filtering and searching the JSONL data that contains your past interactions and session history.

What is the best way to find a specific decision from an older chat session?

The best way to find a specific decision from an older chat session is to search across all sessions for the relevant phrase. The skill queries your JSONL conversation logs to locate the historical context and retrieve the referenced information.

How does searching JSONL chat history work with jq and rg?

Searching JSONL chat history works by using `rg` to rapidly find specific text across log files and `jq` to parse the structured JSON data. This combination allows you to filter past conversations by role, content, or session metadata.

Are there limitations when analyzing large JSONL conversation logs?

When analyzing large JSONL conversation logs, performance depends on the capabilities of `jq` and `rg` on your system. The skill is designed for retrieving historical context and session data, but extremely large datasets may affect search speed.