session-logs

Search and analyze historical Claude Code session logs in JSONL files.

5|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/mraakashshah/oro --skill session-logs-mraakashshah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/mraakashshah/oro/tree/main/.claude/skills/session-logs
Command: npx skills add https://github.com/mraakashshah/oro --skill session-logs-mraakashshah

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps manage and analyze historical Claude Code session logs, allowing users to review past conversations, sessions, and context for reference.

Core Features & Use Cases

  • Search and Analyze Transcripts: Quickly access and analyze JSONL transcripts of past Claude Code sessions.
  • Session Management: Organize and review sessions by date and size.
  • Keyword Search: Locate specific phrases within assistant responses and across all sessions.
  • Message Counting: Determine the number of messages exchanged during a session.
  • Tool Usage Analysis: Break down tool usage within sessions for better insights.
  • Use Case: If you need to understand the history of a particular project or identify trends in discussions, this Skill can help you do so efficiently.

Quick Start

Analyze the session logs for the keyword 'AI' in the last 30 days.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search historical Claude Code session logs for specific keywords?

You can search Claude Code session logs for specific keywords by using the Skill's text search functionality, which relies on the 'rg' tool to locate phrases within assistant responses across JSONL transcripts.

Can I analyze JSONL transcripts to count messages and tool usage in past sessions?

Yes, you can analyze JSONL transcripts to determine the number of messages exchanged during a session and break down tool usage by leveraging the 'jq' dependency for JSONL processing.

Do I need to install jq and rg to process Claude Code session logs?

Yes, you need to install both 'jq' and 'rg' tools, as they are required dependencies for processing JSONL files and performing text searches within the session logs.

What's the best way to organize and review past Claude Code sessions by date?

The best way to review past Claude Code sessions by date is to use this Skill's session management features, which organize historical JSONL transcripts for efficient reference and trend identification.

Why does searching historical session data help with project context?

Searching historical session data helps with project context by allowing you to retrieve past conversations, identify discussion trends, and review previous assistant interactions for reference.

Does session log text analysis work with JSONL files stored locally?

Yes, session log text analysis works with local JSONL files, utilizing 'jq' to parse the JSONL format and 'rg' to execute text searches across the stored session transcripts.