qmd-sessions

Converts Claude Code JSONL session transcripts into searchable Markdown files and indexes them in qmd.

47|5|Updated Mar 3, 2026

Search Tags:#markdown #indexing #session-management #claude-code #transcripts #semantic-search #qmd

Ready to run

npx skills add https://github.com/wbelk/claude-qmd-sessions --skill qmd-sessions

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: qmd-sessions
Source: https://github.com/wbelk/claude-qmd-sessions/tree/main
Command: npx skills add https://github.com/wbelk/claude-qmd-sessions --skill qmd-sessions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts Claude Code session transcripts stored in ~/.claude/projects/ into clean, searchable Markdown files and indexes them in qmd for fast semantic search and retrieval.

Core Features & Use Cases

Convert all JSONL session transcripts into structured Markdown per session, preserving project directories and date-based filenames.
Extract user and assistant turns while skipping tool blocks and system tags; supports subagent transcripts and maintains a consistent, indexable format.
Index content in qmd via MCP for fast semantic and keyword search; hooks keep the index current as sessions evolve.
Use /qmd-sessions refresh to load the most recent exchanges into the current context for fresh sessions.

Quick Start

Run /qmd-sessions to begin the interactive setup wizard and convert your transcripts.

Frequently Asked Questions about qmd-sessions

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

FAQPage Schema

How do I convert Claude Code session transcripts to markdown?▼

Claude Code transcripts stored as JSONL files in ~/.claude/projects/ are converted into structured, searchable Markdown files preserving project directories and date-based filenames.

Can I search through my Claude Code session history with semantic search?▼

Yes, transcripts are indexed in qmd via MCP for fast semantic and keyword search, with hooks that keep the index current as sessions evolve.

How do I load recent Claude Code exchanges into a fresh session?▼

Run /qmd-sessions refresh to load the most recent exchanges from your transcripts into the current context for new sessions.

What is the best way to set up transcript indexing for Claude Code?▼

Run /qmd-sessions to launch a guided, step-by-step setup wizard that safely configures transcript conversion and qmd indexing across sessions.

Does the transcript conversion preserve subagent conversations?▼

The conversion extracts user and assistant turns while skipping tool blocks and system tags, and it supports subagent transcripts to maintain a consistent, indexable format.