/cht

/cht — Chat Persistence for Claude Code

[](https://www.npmjs.com/package/@kosoukhov/cht-cli) [](LICENSE) [](package.json)

Save, search, and continue Claude Code conversations as local markdown files.

13 slash commands for managing conversation history in Claude Code. Every message is crash-proof saved to a markdown file, organized by project, readable offline in any editor.

Installation

Requirements: Node.js 22+, Claude Code CLI.

npm install -g @kosoukhov/cht-cli
cht setup

`cht setup` registers 13 slash commands and 4 auto-save hooks in your Claude Code configuration. Run it once after installation, and again after updates.

Verify the installation:

cht doctor

Quick Start

/cht-new myproject "Auth refactor"                # create a chat
...                                               # work as usual — messages auto-saved
/cht-end                                          # stop recording

On next Claude Code launch:

/cht-continue myproject                           # resume the chat

Commands

Chat Lifecycle

Command	Arguments	Description
/cht-new	[project] [title]	Create a new chat and enable auto-save
/cht-end	--	Stop recording messages
/cht-continue	[project]	Resume a previous chat (loads history + enables recording)
/cht-include	[project]	Load a chat as context (without recording)

Browsing and Search

Command	Arguments	Description
/cht-list	[project] [--recent N] [--tag TAG] [--archived]	List chats with filtering
/cht-search	[project] [--all]	Search by title and content

Management

Command	Arguments	Description
/cht-rename	[project]	Rename a chat
/cht-tag		Add/remove a tag
/cht-archive	[project]	Move to archive

...