session-logs

Search and analyze session JSONL logs by role, timestamp, and keywords.

121|17|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/Zavianx/velaclaw --skill session-logs-zavianx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/Zavianx/velaclaw/tree/main/skills/session-logs
Command: npx skills add https://github.com/Zavianx/velaclaw --skill session-logs-zavianx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill lets you search and analyze your own session logs to quickly recall prior conversations, decisions, and context that may be hidden in memory.

Core Features & Use Cases

  • Global history search: locate user or assistant messages across all sessions stored as JSONL files.
  • Context reconstruction: summarize or extract relevant parts of conversations to reestablish context for current tasks.
  • Audit and compliance: trace decision points and user prompts across sessions for review or debugging.

Quick Start

Search your session logs for a keyword across all sessions and have the AI summarize the matches.

Frequently Asked Questions about session-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search session logs for specific keywords across past conversations?

You can search session logs by filtering JSONL files using jq and ripgrep to locate specific keywords across past conversations. This allows you to retrieve user or assistant messages and provide context for current chats.

Can I filter conversation history by role and timestamp using jq?

Yes, you can filter conversation history by role and timestamp using jq. The skill reads session JSONL files from the active state directory and applies jq filters to extract relevant messages for audit trails or context reconstruction.

What is the best way to reconstruct context from older JSONL session files?

The best way to reconstruct context from JSONL session files is by using jq to extract and summarize relevant conversation parts. This retrieves prior decisions and prompts to reestablish the necessary background for your current tasks.

Does this log-analysis approach require any external dependencies to read JSONL files?

No external dependencies are required to read JSONL files. The skill operates independently using jq and ripgrep to search and analyze session logs stored in the active state directory.

How do I trace decision points and audit trails across multiple chat sessions?

You trace decision points and audit trails across chat sessions by searching session logs with jq. It reads JSONL history files, allowing you to locate specific user prompts and assistant responses for review or debugging.