session-logs

Search and analyze JSONL session logs with jq and rg.

4|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/adamhjouj/shieldclaw --skill session-logs-adamhjouj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/adamhjouj/shieldclaw/tree/main/openclaw/skills/session-logs
Command: npx skills add https://github.com/adamhjouj/shieldclaw --skill session-logs-adamhjouj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search and analyze your own session logs stored in session JSONL files to provide historical context from older conversations.

Core Features & Use Cases

  • Index and locate sessions from the sessions directory.
  • Extract and filter user and system messages across sessions to reconstruct context.
  • Perform keyword searches and lightweight analytics (timestamps, message counts) to surface relevant discussions.

Quick Start

Ask the AI to fetch and summarize your past conversations from your local session logs to provide context.

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 in JSONL session logs?

You can search past conversation history by parsing JSONL session logs stored in your local agents directory to locate specific messages, dates, or keywords across multiple sessions. The Skill filters structured log data to retrieve relevant historical context.

What is the best way to extract specific messages from conversation logs?

The best way to extract specific messages from conversation logs is by applying keyword searches and lightweight analytics directly to JSONL files. This approach surfaces relevant discussions by filtering user and system messages across all stored sessions.

Can I use jq and rg to analyze session logs for auditing?

Yes, you can use jq and rg to analyze session logs for auditing. These tools parse and filter JSONL data to locate specific timestamps, message counts, and keywords, allowing you to reconstruct context from past conversations.

How do I find and summarize old AI conversations for context?

To find and summarize old AI conversations, you index session files from your local sessions directory and extract user and system messages. This reconstructs the historical context needed to continue previous discussions.

Does this approach work with JSONL files stored in local agent directories?

Yes, this approach works directly with JSONL files stored in the local agent sessions directory. It operates on the file path structure to index and locate sessions without requiring external databases.

What are the limitations of searching session logs locally?

A limitation of searching session logs locally is that it relies entirely on the JSONL files currently stored in your agents directory. It cannot retrieve conversations that were deleted or sessions not saved to the local file system.