session-logs

Search and analyze session JSONL logs for historical context.

1|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/sarathi-aiml/openclaw-zero-trust --skill session-logs-sarathi-aiml
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/sarathi-aiml/openclaw-zero-trust/tree/main/skills/session-logs
Command: npx skills add https://github.com/sarathi-aiml/openclaw-zero-trust --skill session-logs-sarathi-aiml

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search and analyze your own session logs (older conversations) stored in session JSONL files to surface historical context and insights.

Core Features & Use Cases

  • Index and filter session logs by session ID, date, or keyword to locate relevant messages.
  • Extract user and assistant messages, timestamps, and usage data for auditing or context rebuilding.
  • Support fast keyword searches across all sessions using jq and rg.

Quick Start

Query your session logs with jq to retrieve all user messages from a specific session.

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 analyze past session logs stored in JSONL files?

You can query session logs using jq and rg to index and filter JSONL files by session ID, date, or keyword. This retrieves relevant user messages, timestamps, and metadata to rebuild historical context or audit past agent conversations.

What is the best way to extract user messages and timestamps from JSONL chat history?

Using jq to parse JSONL chat history is an effective way to extract user and assistant messages alongside timestamps and usage data. It enables fast keyword searches across stored sessions to surface specific conversation details for context rebuilding.

Do I need jq and rg to parse JSONL session logs for audit trails?

Yes, retrieving audit trails from stored session logs requires jq and rg. These command-line tools provide the fast keyword searching and JSONL message filtering capabilities needed to retrieve historical context across multiple agents.

Can I filter past conversations by session ID and date to find specific chat history?

Yes, you can filter past conversations by session ID and date to find specific chat history. The parsing mechanism supports indexing JSONL logs to retrieve targeted messages and metadata from prior agent sessions quickly.

What are the limitations of using command-line tools to aggregate JSONL session logs?

Using command-line tools like jq and rg for JSONL session logs is limited to basic aggregation and keyword searches. Complex relational analysis across historical chat data is restricted without a dedicated database backend for advanced querying.