session-logs

Search and analyze historical session JSONL files using jq and rg.

46|6|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/aresbit/MateBot --skill session-logs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/aresbit/MateBot/tree/main/skills/session-logs
Command: npx skills add https://github.com/aresbit/MateBot --skill session-logs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you locate and analyze older or parent conversations stored in session logs, enabling you to recall context that isn't present in the current memory.

Core Features & Use Cases

  • Search by date or session size to quickly locate relevant transcripts.
  • Extract user messages and key texts from sessions for review.
  • Compute per-session or total costs to audit usage across conversations.
  • Use Case: when a user asks about what was said before, pull from sessions.json index and corresponding .jsonl files to reconstruct context.

Quick Start

List available sessions for an agent, preview a session, and search within sessions using jq and rg.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search historical JSONL session logs to find past conversation context?

You can search historical JSONL session logs to find past conversation context by using jq and rg to query session files stored under ~/.clawdbot/agents/<agentId>/sessions/ and mapping session IDs via sessions.json.

Can I compute total token costs from session logs to audit usage?

Yes, you can compute total costs from session logs to audit usage across conversations. The skill processes session JSONL files to calculate per-session or total costs for reviewing expenditure.

How do I extract user messages from JSONL files for a specific date?

To extract user messages from JSONL files for a specific date, use the skill to locate sessions by date and then parse the corresponding .jsonl files with jq to retrieve key texts.

Do I need jq and rg installed to analyze session JSONL files?

Yes, you need jq and rg installed to analyze session JSONL files. These dependencies are required for searching and extracting data from the session logs stored on your local machine.

What's the best way to locate large sessions by file size in JSONL logs?

The best way to locate large sessions by file size in JSONL logs is to use the skill's search functionality, which supports locating sessions by size to quickly identify relevant transcripts.

Why does reconstructing parent conversation context require sessions.json mapping?

Reconstructing parent conversation context requires sessions.json mapping because it links session IDs to their corresponding .jsonl files, enabling the retrieval of historical data not present in current memory.