session-logs

Query and analyze stored session JSONL logs with jq for historical context.

1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/aayushsoam/clawbot-plus --skill session-logs-aayushsoam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/aayushsoam/clawbot-plus/tree/main/skills/session-logs
Command: npx skills add https://github.com/aayushsoam/clawbot-plus --skill session-logs-aayushsoam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you search and analyze your complete session history stored in session JSONL files, enabling quick access to prior conversations for context and reference.

Core Features & Use Cases

  • Context retrieval: Find and retrieve user and assistant messages from historical sessions to restore context in new chats.
  • Cost-aware insights: Inspect message costs per session to estimate resource usage across conversations.
  • Use Case: When a user asks about something said in a previous discussion, quickly locate and summarize the relevant portion from the sessions archive.

Quick Start

Search my session logs for references to a specific topic and summarize the related conversations.

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 conversations in JSONL session logs?

You can search past conversations in JSONL session logs by applying jq to parse structured session data, filtering by type, timestamp, and message content to retrieve specific historical context.

Can I extract message costs from JSONL session history?

Yes, you can extract message costs from JSONL session history by querying the message.usage.cost.total field, allowing you to estimate resource usage and inspect costs across past conversations.

How do I restore context from previous chat sessions?

To restore context from previous chat sessions, query your stored JSONL session logs to locate user and assistant messages, then summarize the relevant portions to provide historical background for new conversations.

Does this session log analysis tool work with jq?

Yes, this session log analysis tool relies on jq for parsing structured JSONL files, extracting fields like message.role and message.content to surface insights from your session archive.

What is the best way to analyze historical session data for references?

The best way to analyze historical session data for references is to query structured JSONL files using jq, targeting specific topics within the message content to summarize related past discussions.

What limitations exist when parsing JSONL session logs for context?

Parsing JSONL session logs for context requires properly structured data containing fields like type, timestamp, and message.content; sessions lacking these structured fields cannot be effectively queried or analyzed.