Where are the chat logs stored?

Logs are saved within your project's root in a directory named .chats/, organized by date (e.g., 20251225.md).

Can I commit these logs to my Git repository?

Yes, the skill includes instructions for adding and committing the generated markdown files to your project's version control.

What happens if I have multiple sessions in one day?

The skill aggregates user inputs from all sessions for that day into a single daily markdown file with distinct headers for each task.

How does the skill find my Claude Code history?

It automatically encodes your current working directory path to locate the corresponding history files in the ~/.claude/projects/ system folder.

Does this skill export system messages or tool outputs?

No, it is specifically designed to filter out system commands and tool results to focus on clean, human-readable user instructions.

Chat History Extractor

Name: Chat History Extractor
Author: tyrchen

bytyrchen

•

学习与文档

Extracts and organizes Claude Code session history into structured markdown logs within your project's .chats directory.

The Chat History Extractor is a specialized Claude Code skill designed to preserve the context of your AI interactions by automatically mining local session files. It parses encoded project history, filters out system noise and tool outputs, and generates clean, date-stamped markdown files that document every major instruction and request. This is essential for developers who need to maintain an audit trail of AI-driven changes, create manual changelogs, or export prompts for future reuse and team documentation.

主要功能

01Automated extraction of user inputs from local .jsonl session files

02Intelligent filtering of system commands, tool results, and session meta-data

03Organized output into date-based markdown files (YYYYMMDD.md)

04Automatic project path encoding for accurate session directory lookup

05Seamless integration with Git for version-controlled interaction logs

0621 GitHub stars

使用场景

01Maintaining a comprehensive log of instructions given to Claude for project auditing

02Exporting specific prompts and task requirements for documentation or reuse

03Creating a daily interaction changelog to track development progress and AI contributions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tyrchen/claude-skills chat-history

For use in Claude.ai and ChatGPT

Download Skill