session-logs

Search and analyze JSONL session logs using jq filters.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/novolei/if2Ai --skill session-logs-novolei
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/novolei/if2Ai/tree/main/src-tauri/resources/bundled-skills/session-logs
Command: npx skills add https://github.com/novolei/if2Ai --skill session-logs-novolei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables you to quickly locate and analyze past conversations stored as JSONL session logs, helping you reconstruct context and reference prior interactions.

Core Features & Use Cases

  • Session discovery: Find and list sessions by date, size, or metadata.
  • Context reconstruction: Rebuild conversation history for a given session to understand prior context.
  • Targeted queries: Filter messages by role (user/assistant/toolResult), timestamp, or content using jq to extract relevant insights.

Quick Start

Retrieve all messages from a specific session and summarize the prior context.

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 stored as JSONL session logs?

To search past conversations stored as JSONL session logs, you can filter messages by timestamp, role, and content using jq tooling to quickly locate prior interactions and reconstruct context.

Can I filter JSONL session logs by user or assistant roles?

Yes, you can filter JSONL session logs by specific roles such as user, assistant, or toolResult using jq commands to extract targeted insights and reconstruct relevant conversation history.

What is the best way to reconstruct context from past agent sessions?

Reconstructing context from past agent sessions involves retrieving and analyzing complete conversation histories stored in JSONL files, allowing you to review prior interactions and understand the full dialogue context.

How do I find and list specific conversation sessions by date?

You can find and list specific conversation sessions by filtering JSONL session logs based on date, size, or metadata using jq tooling to quickly locate the exact archival records you need.

Do I need jq tooling to analyze JSONL conversation history?

Yes, jq tooling is required to effectively filter and analyze JSONL conversation history, as it enables precise querying by timestamp, role, and message content for fast and accurate retrieval.

Can I use this approach to locate prior tool results across agent sessions?

Yes, you can locate prior tool results across agent sessions by filtering JSONL session logs for toolResult roles using jq, enabling targeted reference lookup and context reconstruction.