session-logs

Search archived session JSONL logs to recover prior conversation context.

5|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/tiancaiamao/ai --skill session-logs-tiancaiamao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/tiancaiamao/ai/tree/main/skills/session-logs
Command: npx skills add https://github.com/tiancaiamao/ai --skill session-logs-tiancaiamao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you recover and analyze information from your own past conversation sessions when the details are no longer in immediate context.

Core Features & Use Cases

  • Session discovery: Locate session files by date, size, or session key to quickly find the conversation you need.
  • Message extraction: Pull only user messages, assistant responses, or tool usage from JSONL transcripts for focused review.
  • History analysis: Summarize message counts, timestamps, costs, and keyword matches across one session or your entire archive.
  • Use Case: A user asks what was said in an older chat, and this Skill helps search the archived session logs to reconstruct the prior discussion accurately.

Quick Start

Ask the skill to search your archived session logs for the relevant session, extract the messages you need, and summarize any matching context or costs.

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 history from older chat sessions?

To search past conversation history, the Skill scans archived JSONL session logs using jq and rg to recover prior context and assistant responses. It filters message roles and matches keywords across your saved chat transcripts to locate specific discussions.

Can I extract specific message types like tool usage from JSONL session logs?

Yes, you can extract specific message types from JSONL session logs. By parsing JSONL records with jq, you can pull only user messages, assistant responses, or tool usage data for focused review and analysis of that specific session.

Do I need jq and rg installed to analyze archived session logs?

Yes, you need both jq and rg installed to analyze archived session logs. These dependencies are required to parse JSONL records, filter message roles, and scan large conversation histories efficiently across your saved agent session directories.

What's the best way to generate a cost summary from conversation logs?

The best way to generate a cost summary from conversation logs is to parse the archived JSONL session files. This allows you to summarize message counts, timestamps, and accumulated costs across one session or your entire chat history archive.

How do I find a specific session file by date or size in my chat history?

You find a specific session file by date or size by scanning your session archive directory. This allows you to locate the exact conversation session files needed based on their chronological timestamps or file size attributes for quick retrieval.

Are there limitations when scanning large JSONL histories for prior context?

When scanning large JSONL histories for prior context, the primary limitation is efficiency. Parsing very large transcript files requires tools like jq and rg to filter message roles and scan records quickly without overwhelming system resources.