session-logs

Search JSONL session transcripts with jq and ripgrep for historical conversations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly locate and analyze older or parent conversations stored in session logs to provide context, audit decisions, and improve future interactions.

Core Features & Use Cases

  • Indexed search: Query session transcripts stored as JSONL using jq and ripgrep for fast, precise results.
  • Context extraction: Retrieve user messages or assistant replies across sessions to build context.
  • Audit and compliance: Review past conversations to verify decisions and responses.

Quick Start

Find all user messages containing the keyword "invoice" from the most recent sessions.

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 chat transcripts for specific keywords?

You can search past chat transcripts by querying JSONL session logs stored under the agents directory using jq and ripgrep to swiftly locate specific keywords and retrieve historical conversations.

What is the best way to audit previous agent interactions for compliance?

Auditing previous agent interactions for compliance is done by reviewing stored JSONL session logs to verify past decisions and responses, allowing you to trace user messages and assistant replies across sessions.

Can I extract user messages from JSONL session logs using jq?

Yes, you can extract user messages from JSONL session logs using jq to parse the transcript structure and retrieve specific message fields, providing precise context extraction for historical references.

Does this tool work with JSONL files stored in local agent directories?

It works directly with JSONL transcript files located under the local agents directory path, querying stored sessions to retrieve historical conversations and provide context for prior agent decisions.

How do I retrieve context from older sessions to inform current chats?

Retrieve context from older sessions by searching stored JSONL transcripts with ripgrep and jq to extract relevant user messages or assistant replies, building historical context for current interactions.

What are the limitations when searching session logs with ripgrep?

A limitation of searching session logs with ripgrep is that it requires JSONL files to be present in the local agents directory, meaning deleted or unlogged sessions cannot be queried or audited.