Clerk auto-summarizes Claude Code sessions into markdown
Clerk is a tool that automatically captures and summarizes Claude Code sessions as local markdown files, with keyword indexing and on-demand reporting capabilities.
Score breakdown
Developers using Claude Code can now automatically maintain searchable records of their coding sessions without manual documentation, enabling faster context retrieval and structured retrospectives across projects.
- 01Clerk automatically hooks into Claude Code session start and end events to capture transcripts and generate summaries
- 02Summaries are stored as markdown files organized by date in ~/.clerk/summary/YYYYMMDD/ directories
- 03The tool provides /clerk-resume and /clerk-search commands for retrieving past session context and searching indexed terms
Clerk is an open-source tool that automates the capture and summarization of Claude Code sessions into local markdown files. The tool operates through session hooks: when a coding session starts, `clerk punch` records the session ID and transcript path; when the session ends, `clerk feed` generates a markdown summary and builds keyword index entries. These artifacts are stored locally in a `~/.clerk/` directory structure organized by date.
`/clerk-resume` reads past summaries and transcripts to provide context within Claude Code.
The tool provides three main user-facing commands. `/clerk-resume` reads past summaries and transcripts to provide context within Claude Code. `/clerk-search` uses semantic matching on indexed terms to find relevant past sessions. `clerk report --days 7` aggregates summaries from the past week and sends them to Claude Code for structured report generation. This workflow enables developers to maintain an auditable record of their coding work across multiple sessions and projects, with the ability to surface context and generate summaries on demand.
Key facts
- 01Clerk automatically hooks into Claude Code session start and end events to capture transcripts and generate summaries
- 02Summaries are stored as markdown files organized by date in ~/.clerk/summary/YYYYMMDD/ directories
- 03The tool provides /clerk-resume and /clerk-search commands for retrieving past session context and searching indexed terms
- 04clerk report --days 7 generates structured weekly reports by aggregating summaries and sending them to Claude Code
- 05The project is open-source under GPL-3.0 license and written in Go
Topics
Summary and scoring are generated automatically from the original article. We always link back to the publisher and never republish images or paywalled content.