save-chat

Context

• Working directory: !pwd
• Current date: !date '+%Y-%m-%d %H:%M'
• Plugin root: ${CLAUDE_PLUGIN_ROOT}

Task

Save the current conversation to a document file. Parse user arguments and guide the export process.

User arguments: $ARGUMENTS

Step 0: Load Settings

Load settings from .claude/chat-saver.local.md following ${CLAUDE_PLUGIN_ROOT}/skills/conversation-export/references/settings-loading.md. Extract: default_format, default_scope, save_dir, custom_header, custom_footer.

Step 1: Parse Arguments

Parse the optional arguments from $ARGUMENTS:

• format — md (default), txt, or html
• scope — full (default) or summary
• --append — Append to an existing file instead of creating a new one
• --last N — Only save the last N conversation turns (each User + Assistant pair = 1 turn)
• --from "keyword" — Save from the first turn containing the keyword to the end
• --raw — Use JSONL session file as data source instead of model memory (ensures 100% complete export, recommended for long conversations)

If $ARGUMENTS is empty, use defaults (md, full, no append, no raw).

If arguments are ambiguous or invalid, use AskUserQuestion to let the user choose:

For format:

• md — Markdown format, preserves code blocks and formatting
• txt — Plain text, clean and portable
• html — HTML with styled layout, viewable in browser

For scope:

• full — Complete conversation history
• summary — Key decisions, code changes, and insights

Step 1.5: Filter Conversation Range

If --last or --from is specified, filter the conversation before processing:

--last N:

• Count conversation turns (each User + Assistant pair = 1 turn)
• Keep only the last N turns
• If N exceeds total turns, keep the entire conversation (no error)

--from "keyword":

• Scan conversation turns from the beginning
• Find the first turn where either the user message or assistant response contains the keyword (case-insensitive)
• Keep that turn and all subsequent turns
• If no turn matches, inform the user and ask whether to save the full conversation instead