session-logs

Search and analyze OpenAEON session JSONL transcripts for historical context across multiple chats.

87|20|Updated Mar 9, 2026

Search Tags:#jq #session history #jsonl #keyword search #cost summary #conversation forensics

Ready to run

npx skills add https://github.com/openaeon/OpenAEON --skill session-logs-openaeon

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/openaeon/OpenAEON/tree/main/skills/session-logs
Command: npx skills add https://github.com/openaeon/OpenAEON --skill session-logs-openaeon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg.

What problem does it solve?

This Skill helps you find what was said in older or parent conversations when that context is not present in current memory, reducing time spent manually scrolling or guessing.

Core Features & Use Cases

Session log discovery and filtering: Locate prior conversations stored as JSONL transcripts under your agent’s sessions directory and narrow results by date, participant role, keywords, or tool usage.
Transcript and insight extraction: Extract user/assistant message text, compute per-session totals (like cost), and summarize activity counts and time ranges.
Cross-session searching: Search across all sessions for a phrase using jq/rg-friendly patterns for quick forensic-style recall.

Quick Start

Ask the assistant: "Use session-logs to find every occurrence of 'project plan' in my previous sessions and summarize the matching user and assistant messages."

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 in JSONL session logs?▼

To search past conversation history in JSONL session logs, use jq and ripgrep-style filtering to locate specific phrases, roles, or tool usage across locally stored transcripts. This extracts matching user and assistant text for immediate recall without manual scrolling.

What is the best way to summarize cost and usage data from old agent sessions?▼

Summarizing cost and usage data from old agent sessions involves reading JSONL transcript files and computing per-session totals, activity counts, and time ranges. This provides an aggregate view of historical expenses and usage patterns for auditing.

Can I use jq and rg to filter conversation transcripts by participant role?▼

Yes, you can use jq and rg to filter conversation transcripts by participant role. These tools apply jq/rg-friendly patterns to JSONL files, allowing you to narrow results specifically to user or assistant messages for targeted forensic recall.

How do I find a specific keyword across multiple parent chat sessions?▼

Finding a specific keyword across multiple parent chat sessions requires cross-session searching across all locally stored JSONL files. Using keyword search patterns, it extracts and returns all matching text occurrences from your historical context.

Do I need jq and rg installed to perform conversation forensics on local session files?▼

Yes, you need jq and rg installed to perform conversation forensics on local session files. The Skill depends on these specific command-line tools to parse JSONL structures and apply rapid text filtering for extracting matching messages and aggregates.