session-logs

Search and analyze stored session JSONL logs with jq and rg.

18|2|Updated Mar 14, 2026

Search Tags:#search #conversation history #jq #cost analysis #session logs #jsonl #rg

Ready to run

npx skills add https://github.com/yuanyuekejiJN/AivoClaw --skill session-logs-yuanyuekejijn

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/yuanyuekejiJN/AivoClaw/tree/main/extraSkills/session-logs-1.0.0
Command: npx skills add https://github.com/yuanyuekejiJN/AivoClaw --skill session-logs-yuanyuekejijn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg.

What problem does it solve?

Session-logs helps you quickly find what was said in earlier or parent conversations when the answer isn’t available in your current context.

Core Features & Use Cases

Session log discovery: Locate relevant session JSONL files stored under your agent’s sessions directory.
Targeted querying: Filter by message role and extract human-readable text content for review or citation.
Analytics and cost insight: Aggregate message counts, extract tool usage breakdowns, and summarize per-session total cost.

Quick Start

Use session-logs to search older conversation transcripts by asking: "Using my session logs, find in which previous sessions the assistant mentioned 'keyword' and show the matching lines."

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 for a specific keyword?▼

To search conversation history for a specific keyword, this Skill uses the rg tool to scan stored session JSONL logs and extract matching lines. It filters by message role to help you quickly recover prior context that is missing from your current memory.

Can I compute token counts and cost analysis from JSONL session logs?▼

Yes, you can compute token counts and cost analysis from JSONL session logs. The Skill uses jq to parse and aggregate JSONL records, summarizing per-session total cost and extracting tool usage breakdowns for comprehensive cost analysis.

Do I need jq and rg installed to search and filter my chat history?▼

Yes, you need jq and rg installed to search and filter chat history. These dependencies are required to deterministically parse, filter, and aggregate the JSONL records stored in your local session directory.

What is the best way to list previous sessions and extract human-readable text?▼

The best way to list previous sessions and extract human-readable text is by using this Skill to locate relevant JSONL files under your agent's sessions directory. It parses the records with jq to extract specific message roles and content.

Why does searching session logs require local access to the agents directory?▼

Searching session logs requires local access to the agents directory because the conversation transcripts are stored as JSONL files under ~/.clawdbot/agents/<agentId>/sessions. The Skill reads these local files directly to ensure deterministic parsing and aggregation.