Claude Session Titler

Claude Session Titler is a Claude Code skill for generating and managing local session titles. It reads a local Claude Code session JSONL file, extracts the first few user messages, asks the configured LLM API for a short Chinese title, and stores the result in a local session-titles.json sidecar file.

Claude Session Titler 是一个 Claude Code 技能，用于生成和管理本地会话标题。它会读取本地 Claude Code 会话 JSONL 文件，提取前几条用户消息，请当前配置的 LLM API 生成一个简短中文标题，并把结果保存到本地 session-titles.json 侧车文件中。

Layout

session-titler/
  SKILL.md
  scripts/
    rename-session.py

Install

Copy the session-titler/ directory into your Claude Code skills directory:

Copy-Item -Recurse -Force ".\session-titler" "$HOME\.claude\skills\session-titler"

安装时，把 session-titler/ 目录复制到 Claude Code 的 skills 目录：

Copy-Item -Recurse -Force ".\session-titler" "$HOME\.claude\skills\session-titler"

Usage

Use /title in Claude Code:

/title
/title list
/title <session-id> "Custom title"
/title delete <session-id>

在 Claude Code 中使用 /title：

/title
/title list
/title <session-id> "自定义标题"
/title delete <session-id>

Command behavior:

• /title: auto-generates a title for the current session.
• /title list: lists titled sessions.
• /title <session-id> "Custom title": manually sets a title.
• /title delete <session-id>: removes a saved title.

命令说明：

• /title：为当前会话自动生成标题。
• /title list：列出已有标题的会话。
• /title <session-id> "自定义标题"：手动设置标题。
• /title delete <session-id>：删除已保存的标题。

Notes

The script reads Claude Code API config from local ~/.claude/settings.json. Do not commit settings.json, session-titles.json, or .jsonl conversation files.

The auto-generation mode sends the first few user messages from the selected local session to your configured LLM API. Avoid using it on sensitive conversations unless you are comfortable with that data flow.

脚本会从本地 ~/.claude/settings.json 读取 Claude Code API 配置。不要提交 settings.json、session-titles.json 或 .jsonl 对话文件。

自动生成模式会把所选本地会话的前几条用户消息发送给你当前配置的 LLM API。如果对话内容敏感，请谨慎使用。