session-logs

Query and analyze JSONL session logs to reconstruct past conversations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Session logs contain the full history of agent conversations. This skill helps you locate and inspect past interactions stored in JSONL files, enabling you to reconstruct context from earlier chats.

Core Features & Use Cases

  • Query and filter session data by session id, date, or user/assistant messages.
  • Extract user or assistant messages for audit, debugging, or context recomposition.
  • Quickly locate conversations referenced in current work or prompts.

Quick Start

Extract the user messages from a specific session to review prior context.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I query past session logs to find specific conversations?

Query past session logs by filtering JSONL files stored under ~/.openclaw/agents/<agentId>/sessions/ using jq. You can locate specific conversations by targeting session IDs, dates, or user messages.

What is the best way to extract user messages from JSONL chat history?

Extract user messages from JSONL chat history by applying jq filters to session logs. The skill parses the timestamp and role fields to isolate user inputs for audit or context recomposition.

Can I review historical agent conversations that are no longer in memory?

Review historical agent conversations no longer in memory by reading the JSONL session files. The skill reconstructs past interactions by parsing the stored logs on your local disk.

Does this tool require jq to filter session logs?

Yes, the tool relies on jq to filter and extract data from the JSONL session files. Jq powers the targeted inspection of chats by date, session ID, or role.

How do I debug prior agent context referenced in current prompts?

Debug prior agent context by extracting the referenced historical interactions from JSONL session logs. The skill filters by session ID or date to locate the exact conversation needed.

What format do session files need to be in for chat history analysis?

Session files must be in JSONL format with timestamps and roles for chat history analysis. The skill assumes files are structured as JSON lines and stored under the agents sessions directory.