session-logs

Search and analyze JSONL conversation logs using jq and rg.

10|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/wixette/clawnotes --skill session-logs-wixette
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/wixette/clawnotes/tree/main/openclaw-snapshots/20260312/skills/session-logs
Command: npx skills add https://github.com/wixette/clawnotes --skill session-logs-wixette

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to search and analyze your past conversation history, which is crucial when a user references older or parent conversations that are not currently in active memory.

Core Features & Use Cases

  • Search Conversation History: Access and query logs stored in JSONL format.
  • Analyze Session Data: Utilize jq for powerful filtering and data extraction from logs.
  • Retrieve Context: Find information from previous interactions to provide continuity.
  • Use Case: If a user asks "What did we decide about the API key in our meeting last week?", this skill can search through your session logs to find that specific decision.

Quick Start

Use the session-logs skill to find all assistant messages containing the keyword "performance" from the session log file named 'session-abc.jsonl'.

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

You can search conversation logs stored in JSONL format by using the `jq` command-line tool for structured JSON data extraction and `rg` for rapid text searching across multiple session files.

What is the best way to retrieve historical context from previous sessions?

Retrieving historical context from previous sessions is done by querying JSONL log files with `jq` to filter specific message fields and `rg` to locate keyword matches across session history.

Do I need jq and ripgrep installed to analyze session data?

Yes, you need both `jq` and `rg` (ripgrep) installed, as `jq` handles the JSON processing and data extraction from logs while `rg` provides efficient text searching within log files.

Can I find user-specific session data across multiple JSONL log files?

Yes, you can analyze communication patterns and retrieve user-specific session data across multiple JSONL log files by utilizing `jq` for powerful filtering and `rg` for efficient text searching.

How do I extract all assistant messages containing a specific keyword from session logs?

To extract assistant messages containing a specific keyword from session logs, pipe the JSONL file through `jq` to filter the message role and use `rg` to match the desired text pattern.

What are the limitations of using command line tools for conversation analysis?

Using command-line tools like `jq` and `rg` for conversation analysis requires logs to be strictly in JSONL format, meaning any malformed JSON lines or non-JSON log files will not be processed correctly.