session-logs

Search and analyze session log files using jq.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/caiazzop/clawdbot-personal-assistant --skill session-logs-caiazzop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/caiazzop/clawdbot-personal-assistant/tree/main/skills/session-logs
Command: npx skills add https://github.com/caiazzop/clawdbot-personal-assistant --skill session-logs-caiazzop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

This Skill allows you to easily search and analyze your past conversation history stored in session log files, helping you recall information that might not be in your immediate memory.

Core Features & Use Cases

  • Session Search: Quickly find specific conversations or information across all your logged sessions.
  • Log Analysis: Analyze session data for insights like message counts, costs, and tool usage.
  • Use Case: You remember discussing a specific project detail with the assistant a few weeks ago but can't recall the exact date. Use this Skill to search your session logs for keywords related to the project to pinpoint the conversation.

Quick Start

List all sessions sorted by date and size.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search conversation history from session log files?

To search conversation history, you can query session log files using jq to filter for specific keywords, dates, or interactions across all logged sessions.

Can I analyze session logs for metrics like message counts and costs?

Yes, you can analyze session logs to calculate metrics such as message counts, tool usage, and costs by applying jq queries directly to the JSON log data.

Do I need jq installed to search and analyze session logs?

Yes, you need the jq binary installed locally, as the session log analysis relies entirely on jq for efficient JSON parsing and filtering of the log data.

What is the best way to recall a specific detail from a past assistant conversation?

The best way to recall past assistant interactions is to search your session logs by keyword to pinpoint the exact conversation and retrieve the needed context.

How do I list all my logged sessions sorted by date and size?

You can list all logged sessions sorted by date and size by running a jq query against your session log directory to aggregate and order the file metadata.

Can I use this approach to audit conversation content and assistant performance?

Yes, auditing conversation content and understanding assistant performance metrics is a core application of analyzing session logs with jq to review past interactions systematically.