session-logs

Search and extract insights from session JSONL files using jq and rg.

Updated May 18, 2022
One-click install
npx skills add https://github.com/kendreaditya/.config --skill session-logs-kendreaditya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/kendreaditya/.config/tree/main/claude/skills/session-logs
Command: npx skills add https://github.com/kendreaditya/.config --skill session-logs-kendreaditya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you quickly locate and analyze older or parent conversations stored in session logs, enabling relevant context restoration without manual search.

Core Features & Use Cases

  • Index and search complete session histories stored as JSONL files to surface user messages, assistant responses, and tool usages.
  • Filter by date, session size, or role to reconstruct contexts for ongoing discussions or audits.
  • Use cases include referencing past chats when a user asks for historical context, auditing a session for decisions, or reviewing what was discussed earlier.

Quick Start

Search your local session logs to locate conversations relevant to a given topic and extract key user messages.

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 retrieve past conversations stored in session JSONL files?

You can search session JSONL files to retrieve past conversations by parsing JSONL transcripts with jq and rg, filtering fields like timestamp, message.role, and message.content to locate specific historical context or user messages.

What is the best way to audit historical context across agent sessions?

Auditing historical context across agent sessions involves indexing complete session histories stored in ~/.openclaw/agents/<agentId>/sessions/, allowing you to filter by date, session size, or role to reconstruct past discussions and decisions.

Do I need jq and rg installed to parse JSONL transcripts for prior chats?

Yes, you need jq and rg installed because this skill requires both tools to parse JSONL transcripts, read JSON objects, and extract insights from your complete session history stored locally.

Can I filter session logs by date or role to reconstruct ongoing discussions?

Yes, you can filter session logs by date, session size, or message role to reconstruct contexts for ongoing discussions, enabling you to surface specific user messages, assistant responses, and tool usages from your history.

What are the limitations when searching local session logs for historical context?

Limitations include relying entirely on local JSONL files in ~/.openclaw/agents/<agentId>/sessions/, requiring jq and rg to parse transcripts, and being constrained to the data fields available within those stored session JSON objects.