session-logs

Query JSONL session logs with jq and ripgrep for context reconstruction.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/pertain99/openclaw-better --skill session-logs-pertain99
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/pertain99/openclaw-better/tree/main/skills/session-logs
Command: npx skills add https://github.com/pertain99/openclaw-better --skill session-logs-pertain99

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly locate and interpret conversations stored in session logs to provide context, traceability, and evidence across agent interactions.

Core Features & Use Cases

  • Search Sessions: Find user and assistant messages by keywords, dates, or session IDs.
  • Context Reconstruction: Assemble a coherent narrative from multiple sessions to understand decisions.
  • Auditing & Reporting: Track session length, message counts, and tool usage for audits.

Quick Start

Ask to retrieve messages from a specific session 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 OpenClaw session logs by keyword or date?

You can locate specific OpenClaw session logs by querying historical session data stored as JSONL using keywords, dates, or session IDs to find targeted user and assistant messages.

What is the best way to reconstruct context from multiple agent sessions?

The best way to reconstruct context from multiple agent sessions is by assembling a coherent narrative from historical JSONL data, enabling you to trace decisions and understand interactions across different sessions.

Do I need jq and ripgrep to parse JSONL session logs?

Yes, you need jq and ripgrep installed to parse JSONL session logs, as these tools are required to query historical data, search for keywords, and generate readable summaries.

Can I audit tool usage and message counts across agent sessions?

Yes, you can audit tool usage and message counts across agent sessions by tracking session length and interactions within the JSONL session logs, providing traceability and evidence for reporting.

How does querying JSONL history help with memory recall in agents?

Querying JSONL history aids memory recall by identifying and extracting past contextual data from session logs, providing the necessary background and decision trail for ongoing agent interactions.

Are there limitations when searching large JSONL session logs?

When searching large JSONL session logs, performance depends on jq and ripgrep; while the tool targets specific extractions, querying extremely large datasets may require filtering by session ID or date to maintain performance.