session-logs

Search JSONL session logs by keyword and summarize matching user/assistant messages with metadata.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Session logs from agent conversations are scattered across files; this skill helps you search, analyze, and summarize past interactions using jq to derive insights and context.

Core Features & Use Cases

  • Search past sessions for keywords across all logs stored as JSONL.
  • Summarize user messages and relevant assistant responses to provide concise context.
  • Filter results by session, timestamp, and user/assistant roles to support audits and debugging.

Quick Start

Search all session logs for a keyword and summarize the relevant 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 past session logs for specific keywords?

To search session logs for keywords, this skill uses jq to scan all stored JSONL conversation history files. It retrieves matching references and generates a concise, structured summary of relevant user messages and assistant responses.

Can I filter conversation history by timestamp, session, and role?

Yes, you can filter conversation history by applying rules based on timestamp, session ID, and user or assistant roles. This allows you to isolate specific interactions for targeted log-analysis, debugging, and auditing past agent sessions.

How does jq work with JSONL log-analysis for agent conversations?

jq processes JSONL log-analysis by querying structured conversation-history files line by line. It identifies specified keywords across all stored session logs and applies filtering rules to extract matching excerpts and counts.

What is the best way to summarize user messages from stored session logs?

The best way to summarize user messages from session logs is using jq filtering to extract relevant interactions. This skill generates a concise, structured summary including counts, excerpts, and session IDs from your JSONL conversation history.

Does this log-analysis skill return results in a structured format for downstream analytics?

Yes, this log-analysis skill returns results in a compact, parseable format suitable for downstream analytics. The output includes structured counts, text excerpts, and session IDs extracted from the filtered JSONL conversation history.

Do I need any dependencies to search and analyze JSONL session logs?

No external dependencies are required to search and analyze JSONL session logs. The skill operates independently using jq to parse conversation history, filter by timestamp or role, and summarize relevant messages.