session-logs

Search and summarize context from JSONL session logs using jq and ripgrep.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locating context from older or parent conversations can be challenging as ideas, decisions, and user intents get scattered across many sessions. This skill provides fast search and analysis of session logs stored as JSONL transcripts using jq and ripgrep, enabling quick recall and auditing.

Core Features & Use Cases

  • Search and filter full conversation history stored in session JSONL files using jq and ripgrep.
  • Extract relevant messages and summarize context across sessions for recall or audit.
  • Use case: when a user references an earlier chat, quickly retrieve the exact messages and timestamps to answer.

Quick Start

Search your past sessions for a keyword to retrieve relevant 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 chat histories stored as JSONL files?

To search past chat histories stored as JSONL files, you can use this skill to filter full conversation transcripts and extract relevant messages using jq and ripgrep. It reads from the OpenClaw state directory to retrieve exact matches.

What is the best way to analyze old session logs for specific context?

Analyzing old session logs for specific context is done by searching and summarizing JSONL transcripts with jq and ripgrep. This approach quickly extracts relevant messages and timestamps across long chat histories for recall or audit.

Do I need jq and ripgrep to extract messages from JSONL transcripts?

Yes, you need jq and ripgrep installed to extract messages from JSONL transcripts. These dependencies are required to perform fast search and retrieval operations across session logs stored in the OpenClaw state directory.

Can I retrieve specific user intents from scattered conversation sessions?

You can retrieve specific user intents from scattered conversation sessions by searching JSONL session logs. The skill locates exact messages and timestamps, enabling quick recall of decisions and ideas across long chat histories.

Where does this skill read session logs from to audit past conversations?

This skill reads session logs from the OpenClaw state directory located at $OPENCLAW_STATE_DIR/agents/<agentId>/sessions. It processes these JSONL transcripts to output concise results suitable for quick review and auditing.