conversation-reader

Extract Claude conversation history from JSONL logs with composable filters.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/MariusWilsch/claude-code-conversation-store --skill conversation-reader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conversation-reader
Source: https://github.com/MariusWilsch/claude-code-conversation-store/tree/main/plugins/claude-code-team-plugin/skills/conversation-reader
Command: npx skills add https://github.com/MariusWilsch/claude-code-conversation-store --skill conversation-reader

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading and auditing Claude conversation histories from JSONL logs is tedious and error-prone. The Conversation Reader enables composable filters to selectively extract user messages, assistant responses, and tool calls across sessions.

Core Features & Use Cases

  • Composable filters to include only user, assistant, or tool messages.
  • Useful for audits, verification, and compliance reviews of past sessions.
  • Integrates with existing workflows to validate outputs and track tool usage.

Quick Start

Provide the path to a Claude conversation JSONL file and request the reader to extract the desired message streams (user, assistant, and tools).

Frequently Asked Questions about conversation-reader

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

FAQPage Schema
How do I extract user and assistant messages from Claude JSONL logs?

To extract user and assistant messages from Claude JSONL logs, you provide the file path and apply composable filters to selectively isolate specific message streams, ensuring deterministic output for verification.

What is the best way to audit past Claude conversations across multiple projects?

Auditing past Claude conversations across multiple projects is best handled by applying composable filters to JSONL logs, selectively extracting user messages, assistant responses, and tool calls for compliance review.

Can I filter JSONL conversation history to only show tool calls?

Yes, you can filter JSONL conversation history to only show tool calls by applying the specific composable filters designed to include or exclude individual message types like tool usage.

Does this approach for extracting conversation history work efficiently with large log files?

Extracting conversation history with this approach works efficiently with large log files through deterministic output generation and optimized handling of large JSONL session histories.

Why should I use composable filters instead of manually reading JSONL session logs?

You should use composable filters instead of manually reading JSONL session logs because manual extraction is tedious and error-prone, whereas filters guarantee deterministic output and accurate message isolation.

How do I verify tool usage and assistant responses in Claude session logs?

To verify tool usage and assistant responses in Claude session logs, you extract the desired message streams from your JSONL file using composable filters to isolate specific data for review.