session-logs

Search and extract messages from session JSONL files with date and keyword filters.

5|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/JansenAnalytics/claudex --skill session-logs-jansenanalytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/JansenAnalytics/claudex/tree/main/skills/session-logs
Command: npx skills add https://github.com/JansenAnalytics/claudex --skill session-logs-jansenanalytics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search and analyze your complete conversation history stored in session JSONL files, helping you reference older chats or forgotten context.

Core Features & Use Cases

  • Indexes and searches sessions stored in ~/.openclaw/agents/<agentId>/sessions/
  • Extracts user or assistant messages, timestamps, and cost summaries
  • Supports keyword, date, and session-filter queries across all sessions
  • Use case: Retrieve a specific user message from a past session to verify context for a new task.

Quick Start

Ask me to locate a conversation from a specific date or search for a keyword across all sessions.

Frequently Asked Questions about session-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search conversation history stored in JSONL session files?

You can retrieve specific messages from past JSONL session logs by applying date-range filters, keyword searches, and role-based extraction. It uses jq for parsing JSONL data and rg for keyword scanning.

How do I extract user or assistant messages with timestamps from session logs?

Extract user or assistant messages from session logs by applying role-based message extraction to your JSONL files. This surfaces structured data including message roles, timestamps, and usage costs.

Can I filter past session logs by specific dates and keywords?

Yes, you can filter past session logs by applying date-range filters and keyword searches across all stored sessions. This identifies and retrieves relevant historical conversations matching your criteria.

Does jq work with JSONL conversation history files for parsing?

Yes, jq works with JSONL conversation history files for parsing structured schema data including messages, timestamps, roles, and usage costs. It enables precise extraction of specific context from your stored sessions.

What is the best way to ground current work in past conversation context?

To ground current work in past conversation context, retrieve historical conversations stored as session JSONL files. Apply date-range filters and keyword searches to surface and verify relevant context from previous sessions.