session-logs

Search JSONL session archives for messages, keywords, and costs.

2|Updated May 23, 2026
One-click install
npx skills add https://github.com/enclawed/enclawed-oss --skill session-logs-enclawed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/enclawed/enclawed-oss/tree/main/skills/session-logs
Command: npx skills add https://github.com/enclawed/enclawed-oss --skill session-logs-enclawed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you search and analyze your own older conversation logs when the answer is no longer in immediate memory, making it easy to recover prior context, decisions, and references.

Core Features & Use Cases

  • Session Discovery: Locate chat sessions by date, size, or provider index.
  • Transcript Analysis: Extract user, assistant, and tool-result messages from JSONL logs.
  • Keyword Search: Search across one session or your full session archive for a phrase, topic, or remembered snippet.
  • Cost and Usage Review: Summarize per-session usage, message counts, and total cost.
  • Use Case: A teammate asks what was decided in a previous discussion, and you quickly find the relevant session, pull the exact messages, and summarize the outcome.

Quick Start

Ask the skill to search your session history for a topic or phrase and return the matching messages with a concise summary of what was discussed.

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 log files?

To search past conversation history, you can use keyword lookup to find specific phrases or topics across your JSONL session logs, extracting the exact messages and summarizing the discussion outcomes.

Can I analyze session logs to find a previous chat by date or size?

Yes, you can analyze session logs to discover specific past chats by filtering sessions based on date, file size, or provider index using the sessions.json index file.

Do I need jq and ripgrep installed to extract messages from JSONL transcripts?

Yes, you need jq and ripgrep installed in your environment to perform session discovery, message extraction, and keyword search across your JSONL conversation transcripts.

How do I calculate token usage and total cost from past chat session logs?

You can calculate token usage and total cost by summarizing per-session usage data and message counts directly from the JSONL conversation logs stored in your state directory.

What is the best way to recover lost context from older agent conversation transcripts?

The best way to recover lost context is searching your session archive for remembered snippets or keywords, pulling user, assistant, and tool-result messages from the JSONL transcripts.

Are there limitations when searching session logs for prior discussions across different providers?

Session log searching is limited to older or parent chats stored as JSONL transcripts in the active Enclawed state directory, requiring access to the agent-specific sessions directory and sessions.json index.