skills.rest
victor-brechbill
victor-brechbillOFFICIAL
Explore all skills by this author →
GitHub

session-logs

Search and analyze JSONL conversation logs using jq and rg.

1|Updated Feb 24, 2026
Search Tags:#logs#analysis#search#history#jq#session
One-click install
npx skills add https://github.com/victor-brechbill/claw-kernel --skill session-logs-victor-brechbill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/victor-brechbill/claw-kernel/tree/main/skills/session-logs
Command: npx skills add https://github.com/victor-brechbill/claw-kernel --skill session-logs-victor-brechbill

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 retrieve historical context or information that is not currently in memory.

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, sort, and extract specific information like user messages, assistant responses, costs, and tool usage from session files.
  • Use Case: When a user asks about a decision made in a previous, unrelated conversation, you can use this skill to quickly locate and present that historical context.

Quick Start

Use the session-logs skill to search for sessions containing 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 files?▼

You can search past conversation logs stored in JSONL files by using jq and rg to filter, sort, and extract specific user messages, assistant responses, or historical context from session transcripts.

What's the best way to analyze session costs from historical chat transcripts?▼

Analyzing session costs from historical chat transcripts is done by querying JSONL session files with jq to extract and calculate cost data alongside user and assistant messages.

Do I need jq and rg installed to query session history?▼

Yes, you need both jq and rg installed, as these command-line tools are required dependencies to efficiently parse, search, and query the JSONL session data.

Can I retrieve historical context from an unrelated previous conversation?▼

Yes, you can retrieve historical context from an unrelated previous conversation by searching session logs directly from stored JSONL files to locate past decisions or information.

Where are my conversation session logs stored for log analysis?▼

Conversation session logs for log analysis are stored as JSONL files within the ~/.openclaw/agents/<agentId>/sessions/ directory, allowing direct access for querying and data extraction.

Related Skills

Explore More Software Engineering Skills→
openoctaopenocta
3.1k

session-logs

Search and analyze past session logs in JSONL files using jq and rg.

Community
Intermediate
winsorllcwinsorllc

context-aggregator

Aggregate conversation history, file operations, and token usage into unified session summaries.

Community
Intermediate
wixettewixette
10

session-logs

Search and analyze JSONL conversation logs using jq and rg.

Community
Intermediate
sky770825sky770825

session-logs

Search and analyze past conversation transcripts in JSONL files using jq and rg.

Community
Intermediate