session-logs

Extract messages, timestamps, and roles from session JSONL files with jq.

588|41|Updated May 13, 2026
One-click install
npx skills add https://github.com/zai-org/Synapse --skill session-logs-zai-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/zai-org/Synapse/tree/main/.setup/skills/clawhub/skills/session-logs
Command: npx skills add https://github.com/zai-org/Synapse --skill session-logs-zai-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables you to search and analyze your complete session history stored in JSONL files to recall context from older or parent conversations.

Core Features & Use Cases

  • Search past sessions: quickly locate prior conversations by date, session id, or keywords using jq queries.
  • Context reconstruction: retrieve user or assistant messages to understand prior decisions or actions.
  • Use Case: When a user references older chats, you can reconstruct the context to answer effectively.

Quick Start

Investigate past conversations by querying the session logs for a specific keyword to retrieve user messages and 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 conversation history from local JSONL session logs?

You can search past conversation history by running jq queries against local JSONL session logs to extract specific messages, timestamps, and roles. This allows you to locate prior conversations by date, keywords, or session ID.

How do I reconstruct context from older parent sessions using jq?

Reconstruct context from older parent sessions by applying jq to filter JSONL transcripts for specific keywords or session IDs. This retrieves the relevant user and assistant messages to understand prior decisions and actions effectively.

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

Yes, you need jq installed to extract messages from JSONL transcripts. The skill requires jq to query local stored JSONL files and retrieve conversation history data including timestamps and roles.

Can I audit conversation history across all stored sessions or just specific ones?

You can audit conversation history across all stored sessions or specific sessions by adjusting your jq queries. This allows you to target the entire JSONL transcript collection or isolate individual session logs for review.

What is the best way to verify past decisions from JSONL conversation logs?

The best way to verify past decisions from JSONL conversation logs is to use jq queries targeting specific keywords or dates. This extracts the relevant user and assistant messages to understand prior decisions and actions effectively.