session-logs

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

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/Team-Hireal/RealChat --skill session-logs-team-hireal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/Team-Hireal/RealChat/tree/main/openclaw/skills/session-logs
Command: npx skills add https://github.com/Team-Hireal/RealChat --skill session-logs-team-hireal

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 is crucial when a user refers to older or parent conversations that are not currently in active memory.

Core Features & Use Cases

  • Session Log Search: Query historical conversation data stored in JSONL files.
  • Data Analysis: Extract specific message types (user, assistant, tool results) and analyze costs or message counts.
  • Use Case: A user asks, "What did we decide about the project timeline last week?" You can use this skill to search through your session logs to find the relevant discussion and provide the answer.

Quick Start

Use the session-logs skill to search across all sessions for the phrase "project timeline".

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 commands. This skill filters and retrieves historical session data so you can find specific discussions or context from older conversations.

What is the best way to extract specific message types from session data?

The best way to extract specific message types like user, assistant, or tool results from session data is by querying JSONL files with jq. This allows you to filter historical conversation logs and analyze messages or costs.

Do I need jq and rg installed to search conversation history?

Yes, you need jq and rg installed to search conversation history. This skill requires these two dependencies to filter and search session data stored in JSONL files for retrieving past context.

Can I analyze costs and message counts from historical conversation logs?

Yes, you can analyze costs and message counts from historical conversation logs. By using jq to query your session data, you can extract and calculate metrics from past JSONL conversation records.

How does an agent retrieve context from parent conversations not in active memory?

An agent retrieves context from parent conversations by searching past session logs. This skill uses rg and jq to find and extract relevant historical data from JSONL files, allowing agents to reference older discussions.