session-logs

Search and analyze JSONL conversation logs using jq and ripgrep.

93|20|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/seedprod/openclaw-prompts-and-skills --skill session-logs-seedprod
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/seedprod/openclaw-prompts-and-skills/tree/main/.claude/skills/session-logs
Command: npx skills add https://github.com/seedprod/openclaw-prompts-and-skills --skill session-logs-seedprod

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 logs, which are stored in JSONL files, enabling you to recall historical context or information from previous interactions.

Core Features & Use Cases

  • Session Log Access: Directly access and query conversation transcripts stored in ~/.openclaw/agents/<agentId>/sessions/.
  • Data Analysis: Utilize jq and rg to filter, extract, and summarize information from session logs, such as user messages, assistant responses, costs, and tool usage.
  • Use Case: If a user asks about a decision made in a conversation from last week, you can use this skill to quickly find that session and extract the relevant discussion.

Quick Start

Use the session-logs skill to search across all sessions 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 logs stored in JSONL format?

To search past conversation logs in JSONL format, you can use command-line tools like jq and rg to filter and extract historical context, user messages, and assistant responses from session files. This enables quick retrieval of previous interactions.

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

Yes, you need jq and ripgrep installed to analyze session history. These command-line tools are required dependencies for efficient JSONL log parsing and pattern matching when retrieving cost data and conversation transcripts.

How do I extract specific user messages and assistant responses from JSONL session files?

You extract specific user messages and assistant responses from JSONL session files by utilizing jq to parse the structured data and rg to match patterns. This allows you to filter transcripts and summarize information from agent sessions.

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

The best way to retrieve historical context from previous agent sessions is querying the JSONL logs stored in your agents directory. Using jq and rg for pattern matching allows you to quickly find specific discussions and decisions from past conversations.

Can I analyze cost data and tool usage from past conversation logs?

Yes, you can analyze cost data and tool usage from past conversation logs. The session-logs capability utilizes jq to filter and summarize this information directly from the JSONL transcripts stored in your local agent session directories.

What are the limitations of using command-line tools for session log analysis?

Limitations of using command-line tools for session log analysis include the requirement to have jq and ripgrep installed. Additionally, you must manually construct search patterns to query the raw JSONL files rather than using a visual interface.