session-logs

Search and analyze session histories in JSONL files using jq.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/DharambirAgrawal/Personal-Assistant --skill session-logs-dharambiragrawal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/DharambirAgrawal/Personal-Assistant/tree/main/skills/session-logs
Command: npx skills add https://github.com/DharambirAgrawal/Personal-Assistant --skill session-logs-dharambiragrawal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you locate and understand important details from long conversation histories stored as session JSONL files, without manual sifting.

Core Features & Use Cases

  • Search across all sessions to find specific user or assistant messages, timestamps, or cost data.
  • Summarize historical context for a given topic or session to inform current decisions.
  • Use Case: When a user asks about what was said earlier in a conversation, quickly pull relevant quotes and context to respond accurately.

Quick Start

Tell the AI to scan your local session logs and return a concise summary of recent 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 past chat histories stored as JSONL files?

You can search past chat histories by parsing session JSONL files with jq to locate specific user or assistant messages, timestamps, and cost data without manual sifting.

What is the best way to retrieve historical context from previous sessions?

Retrieving historical context from previous sessions involves scanning standard session directories to summarize prior conversations, allowing you to pull relevant quotes and context to inform current decisions.

How do I analyze session logs to find specific user messages and cost data?

You analyze session logs by applying jq to parse JSONL records, filtering across all sessions to find specific user messages, assistant responses, timestamps, or associated cost data.

Does this session search approach require any external dependencies or components?

No external dependencies or components are required. It reads directly from the standard local session directory at ~/.clawdbot/agents/<agentId>/sessions/ and uses jq for JSONL parsing.

Can I summarize what was said earlier in a long conversation automatically?

Yes, you can scan your local session logs to return a concise summary of recent sessions, pulling relevant quotes and historical context to respond accurately about what was said earlier.

When do I need to parse JSONL session files for conversation analysis?

You need to parse JSONL session files when you must locate and understand important details from long conversation histories stored locally, avoiding the manual sifting required to find prior topics or quotes.