conversation-saver

Claude Conversation Saver Plugin

A lightweight Claude Code plugin that adds automatic conversation saving via hooks and slash commands. Built on top of the conversation-logger skill.

What is This?

This plugin is an automation wrapper around the conversation-logger skill:

• The skill contains all the core logic (saving, parsing, searching)
• This plugin adds automatic triggers (Stop hook) and convenience commands

Why This Approach?

Hybrid Benefits:

• ✅ Single source of truth: All core logic lives in the skill
• ✅ Real-time automatic saves: Plugin hook triggers after each response
• ✅ User choice: Use just the skill manually, or add the plugin for automation
• ✅ Easy maintenance: Update the skill, plugin automatically benefits
• ✅ Cross-platform: Skill works everywhere, plugin adds Claude Code automation

Features

• 🔄 Auto-saves conversations after each Claude response in real-time
• 📝 Converts to markdown - readable conversation transcripts
• 🔍 Powerful search - find past conversations instantly
• 📊 Browse recent - quickly review recent sessions
• 💾 Full metadata - preserves session info and timestamps
• ⚡ Slash commands - convenient /convo-* commands

Installation

Quick Install

Step 1: Add the marketplace:

/plugin marketplace add https://github.com/sirkitree/claude-conversation-saver

Step 2: Restart Claude Code to load the plugin.

That's it! The plugin will automatically:

• Install the conversation-logger skill if not present
• Set up the Stop hook (saves after each response)
• Add slash commands: /convo-search, /convo-list, /convo-recent

Prerequisites

Make sure you have:

• git - For cloning the skill
• jq - JSON processor (for hook data parsing)
• python3 - For parsing conversations to markdown

# Termux
pkg install git jq python -y

# macOS
brew install git jq python3

# Debian/Ubuntu
sudo apt install git jq python3

Usage

Automatic Saving

Once installed, conversations are automatically saved after each Claude response. No action needed!

Each response creates/updates files in ~/.claude/conversation-logs/:

• conversation_YYYY-MM-DD_HH-MM-SS.jsonl - Raw conversation data
• conversation_YYYY-MM-DD_HH-MM-SS.md - Human-readable transcript
• session_YYYY-MM-DD_HH-MM-SS.json - Session metadata
• conversation_latest.md - Symlink to most recent conversation

Slash Commands

The plugin adds three convenient slash commands:

Search conversations:

/convo-search hooks

List all saved conversations:

/convo-list

Show recent conversations:

/convo-recent 10

Using the Skill Directly

You can also use Claude naturally - the skill activates automatically when you ask:

• "Save this conversation"
• "Search conversations about docker"
• "When did we work on authentication?"

Or run the scripts directly:

# Search
~/.claude/skills/conversation-logger/scripts/search-conversations.sh "search-term"

# List all
~/.claude/skills/conversation-logger/scripts/search-conversations.sh --list

# Recent
~/.claude/skills/conversation-logger/scripts/search-conversations.sh --recent 5

How It Works

1. Plugin Installation: Install script ensures the conversation-logger skill is present
2. Stop Hook: Triggers after each Claude response, calls skill's save script
3. Skill Execution: Skill saves JSONL, converts to markdown, creates metadata
4. Search Anytime: Use slash commands or skill directly to find conversations

Architecture

Plugin (Automation Layer)
    ↓ calls
Skill (Core Logic)
    ↓ creates
Saved Conversations (~/.claude/conversation-logs/)

Plugin provides:

• Stop hook → real-time automatic saving after each response
• Slash commands → convenience shortcuts
• Install script → ensures skill is present

Skill provides:

• Save script → JSONL to markdown conversion
• Search script → full-text search with context
• Parse script → readable conversation formatting

Real-Time Saving Behavior

The Stop hook fires after every Claude response, providing real-time conversation backups:

• ✅ Conversations are saved continuously as they evolve
• ✅ Each response updates the conversation files with the latest content
• ✅ Never lose work - even if Claude Code crashes, your conversation is preserved
• ✅ Great for long sessions - you can review progress at any time

This means you always have an up-to-date snapshot of your conversation, no need to wait for the session to end!

Plugin Structure