chat-history-export

Export and search local Cline session JSON as markdown files.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill chat-history-export-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chat-history-export
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/chat-history-export
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill chat-history-export-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Local AI conversation history in Cline sessions is stored as raw JSON files that are hard to browse, search, or preserve. This Skill converts those sessions into readable markdown records so past work can be reviewed, searched, and archived before major workspace changes. ## Core Features & Use Cases - Markdown Export: Converts Cline session metadata and message JSON into structured markdown files with timestamps, roles, model info, and token metrics. - Search and List: Searches across all past sessions by keyword or lists recent sessions with titles and dates. - Incremental Tracking: Skips unchanged sessions using a hash-based tracking file, with a --force option to regenerate. - Use Case: Before a major refactor, run a dry-run export to inventory past sessions, then export relevant ones to markdown so design decisions and prior context remain available as durable documentation. ## Quick Start Ask the assistant to export your recent Cline chat history to markdown, or to search past sessions for a specific topic like "workspace cleanup".

Frequently Asked Questions about chat-history-export

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

FAQPage Schema
How do I export Cline chat history to markdown?

Run the export command with python3 scripts/export_cline_history.py export from the skill folder. It reads sessions from ~/.cline/data/sessions and writes markdown files to ~/.cline/chat-history, skipping sessions already exported unchanged.

How do I search past Cline sessions for a topic?

Use the search subcommand with a query string, such as python3 scripts/export_cline_history.py search "workspace cleanup". It scans session metadata and message content and prints matching sessions with their start date, ID, and title.

Does the export include secrets or API keys?

No. The skill explicitly treats ~/.cline/data/secrets.json and provider settings as sensitive runtime state and never exports or quotes those files. Only session metadata and message content are processed.

Why does the export skip some sessions?

The script stores a SHA-256 hash of each session's messages file in .exported_sessions.json. If a session has not changed since the last export, it is skipped; use the --force flag to regenerate all exports.

Can I preview the export before writing files?

Yes. Run the export command with --dry-run to print which sessions would be written and their target paths without creating any files. This is recommended when you only need a review or inventory.