session-logs

Search and analyze JSONL conversation logs using jq and ripgrep.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hummbl-dev/hummbl-agent --skill session-logs-hummbl-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/hummbl-dev/hummbl-agent/tree/main/skills/session-logs
Command: npx skills add https://github.com/hummbl-dev/hummbl-agent --skill session-logs-hummbl-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows you to search and analyze your past conversation history stored in session log files, which is useful when users refer to older or parent conversations.

Core Features & Use Cases

  • Search Session Logs: Access and query historical conversation transcripts.
  • Analyze Past Data: Understand context from previous interactions that are not in current memory.
  • Use Case: A user asks about a decision made in a meeting from last week. You can use this skill to search the session logs from that period to find the exact discussion and outcome.

Quick Start

Use the session-logs skill to find all sessions from January 6th, 2026.

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 conversation logs stored in JSONL format?

To search past conversation logs stored in JSONL format, you can use jq and ripgrep to query and filter historical user and assistant messages, retrieving specific interactions from session files.

Can I retrieve cost data and tool usage from session log history?

Yes, you can retrieve cost data and tool usage from session log history. The skill queries JSONL session files using jq to extract and analyze past cost metrics alongside the conversation transcripts.

Do I need jq and ripgrep installed to analyze conversation transcripts?

Yes, you need both jq and ripgrep installed to analyze conversation transcripts. They are required dependencies for efficiently performing text searching and JSON filtering within the log files.

What's the best way to find a decision from a previous session log?

The best way to find a decision from a previous session log is to search the JSONL history using jq. This allows you to query historical user and assistant messages to locate the exact discussion and outcome.

How does searching session logs with jq work for accessing older conversations?

Searching session logs with jq works by processing JSONL files to retrieve historical messages, cost data, and tool usage that are no longer in current memory, enabling analysis of specific or all past sessions.

Are there limitations when using jq to search conversation history?

A limitation when using jq to search conversation history is that it only accesses data persisted in JSONL log files; interactions not saved to these session files cannot be retrieved or analyzed.