session-logs

Search and analyze historical JSONL session logs using jq and rg.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/planetazuzu/planetazuzu-memory --skill session-logs-planetazuzu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/planetazuzu/planetazuzu-memory/tree/main/skills/openclaws-kb/skills/session-logs
Command: npx skills add https://github.com/planetazuzu/planetazuzu-memory --skill session-logs-planetazuzu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg.

What problem does it solve?

This Skill allows you to search and analyze your past conversation history, enabling you to recall information from previous interactions or understand the context of older/parent conversations.

Core Features & Use Cases

  • Search Session Logs: Access and query conversation transcripts stored in JSONL files.
  • Analyze Conversation Data: Use jq to filter and extract specific information like messages, costs, and tool usage.
  • Use Case: If a user asks about a decision made in a previous chat session, you can use this skill to find that session and retrieve the relevant details.

Quick Start

Use the session-logs skill to search across all session files for the phrase "project deadline".

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 for specific text?

You can search past conversation history by querying JSONL session logs using `rg` for text matching and `jq` for structured data extraction. This allows you to quickly locate specific phrases, decisions, or context from previous chat transcripts.

Can I analyze message costs and tool usage data from JSONL session logs?

Yes, you can analyze message costs and tool usage from JSONL session logs by applying `jq` filters. This Skill extracts and structures specific fields from your conversation data, enabling you to audit chat history and review past interactions efficiently.

What do I need to retrieve context from previous chat sessions?

To retrieve context from previous chat sessions, you need your conversation history stored in JSONL format and the command-line utilities `jq` and `rg` installed. These dependencies enable efficient log parsing and text searching across your session files.

Is there a way to query conversation transcripts without writing complex scripts?

Querying conversation transcripts is possible without writing complex scripts by using this Skill's built-in `jq` and `rg` integration. It handles the underlying log parsing logic, allowing you to retrieve specific message content or cost data from JSONL files directly.

What is the best way to audit chat history stored in JSONL format?

The best way to audit chat history in JSONL format is to use `jq` to extract and filter specific session data fields. This approach allows you to systematically review conversation content, track tool usage, and analyze historical costs across all logged sessions.