pellucid
Chat Naming for Claude Code: short, consistent session titles from the agent's own understanding of the task. By Pellucid Studio.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/pellucid-studio--chat-naming)HTML
<a href="/listings/pellucid-studio--chat-naming"><img src="/api/listings/pellucid-studio--chat-naming/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
In Claude Code 2.1.275 or later, install it in one step:
/plugin install pellucid-chat-naming --marketplace Pellucid-Studio/chat-naming
On an older Claude Code, add the marketplace first, then install:
/plugin marketplace add Pellucid-Studio/chat-naming /plugin install pellucid-chat-naming@pellucid
The same commands work in a terminal as `claude plugin …`. The plugin needs Node.js 22.13 or later on your `PATH` (see Requirements). Start a new session after installing. To update later, run `/plugin marketplace update pellucid`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 25 lines
- {
- "name": "pellucid",
- "owner": {
- "name": "Pellucid Studio",
- "url": "https://pellucid.studio/"
- },
- "metadata": {
- "description": "Claude Code plugins by Pellucid Studio."
- },
- "plugins": [
- {
- "name": "pellucid-chat-naming",
- "source": "./",
- "description": "Short, consistent session titles from the main agent's own understanding of the task. No extra model call; titles you set yourself are never overwritten.",
- "version": "0.2.0",
- "author": {
- "name": "Pellucid Studio"
- },
- "homepage": "https://pellucid.studio/chat-naming/",
- "repository": "https://github.com/Pellucid-Studio/chat-naming",
- "license": "MIT",
- "category": "productivity"
- }
- ]
- }
README.md · README · 82 lines
- <p align="center"><img src=".claude-plugin/icon.png" width="112" alt="Chat Naming icon"></p>
- # Chat Naming
- Chat Naming gives each Claude Code session a short, readable title such as `Release pipeline · phase 1 — Roll back failed deploys`. The title comes from the main agent's own understanding of your first real request, so the plugin makes no extra model call. A title you set yourself is never overwritten.
- 
- The `claude --resume` picker after four real sessions with the plugin installed. Each title was written by the plugin from the first request.
- ## Install
- In Claude Code 2.1.275 or later, install it in one step:
- ```
- /plugin install pellucid-chat-naming --marketplace Pellucid-Studio/chat-naming
- ```
- On an older Claude Code, add the marketplace first, then install:
- ```
- /plugin marketplace add Pellucid-Studio/chat-naming
- /plugin install pellucid-chat-naming@pellucid
- ```
- The same commands work in a terminal as `claude plugin …`. The plugin needs Node.js 22.13 or later on your `PATH` (see Requirements). Start a new session after installing. To update later, run `/plugin marketplace update pellucid`.
- ## How it works
- 1. On your first ordinary prompt in an untitled session, the plugin adds one short instruction to that turn. It asks the agent to call the plugin's `set_chat_title` tool with a topic, a focus and a language marker, and to keep working on your task.
- 2. After the agent's answer ends, the plugin applies the title with Claude Code's built-in `/rename` command.
- 3. On the next session event, the plugin compares the title Claude Code reports with the title it wrote and records the result as verified, failed or conflicting.
- 4. If you rename the session yourself with `/rename`, the plugin freezes automatic naming for that session. `/chat-naming unfreeze` adopts your title as the new baseline.
- 5. When the focus of the work changes substantially, the agent may update the focus. The topic and phase number stay the same.
- Greetings, one-word replies and slash commands do not trigger naming. Sessions that already have a title are left alone. The plugin approves calls to its own `set_chat_title` tool from the main conversation, so you are not asked each time, and refuses calls from subagents. Any deny rule you set still applies.
- ## Commands
- - `/chat-naming status`: shows whether naming is active, the Node.js runtime it found and the state of this session.
- - `/chat-naming freeze` and `/chat-naming unfreeze`: stop or resume automatic naming for this session.
- - `/chat-naming handoff [continuation|branch|subtask]`: prints one line to paste into a new session so that it continues the same topic as the next phase, a branch or a subtask. No session is created automatically.
- ## Settings
- The plugin asks for three optional values when you install it:
- - **Naming state directory**: where the plugin keeps its local ledger. Leave it empty to use `pellucid-chat-naming` inside your Claude configuration directory. The environment variable `CHAT_NAMING_STATE_DIR` overrides it.
- - **Rename in Claude Desktop sessions**: off by default, because title behavior in the Claude desktop app's Code tab is not verified.
- - **Answers between focus updates**: how many completed answers must pass before the agent is invited to update the focus again. Default 3.
- Set `CHAT_NAMING_DEBUG=1` to print diagnostic lines in the transcript.
- ## What it runs
- The plugin is a Claude Code mod: `hooks/register.ts` and the files in `src/` run inside Claude Code. For every ledger operation it starts `node --no-warnings libexec/chat-naming-core.mjs --state-dir <state directory>` with one JSON request on standard input, and reads one JSON answer. At the first session event it runs the same file with `--probe` to check the Node.js version. `libexec/` contains readable JavaScript generated from the project's TypeScript sources with the types removed, and `libexec/sqlite.mjs` adapts Node's built-in `node:sqlite` module. Nothing is downloaded or installed.
- ## Data and privacy
- - **No network access.** Neither the mod nor the local core makes network requests, and the plugin calls no model of its own. It does not send data to Anthropic, Pellucid Studio or any third party.
- - **What it reads:** the session id, the working directory and project root, the current session title that Claude Code reports, and which surface draws the session. It sees the topic and focus that the agent passes to its tool. It does not read your files or the conversation transcript.
- - **What it writes:** the session title, through Claude Code's own `/rename` command, and a local SQLite ledger on your machine. The ledger holds session ids, topics, focus phrases, titles, phase numbers, handoff records and a SHA-256 hash of the project path. The directory is created with owner-only permissions (0700) and the file with 0600.
- - **Retention:** the ledger stays until you delete it. Uninstalling the plugin does not delete it; remove the state directory yourself if you no longer want it.
- ## Requirements and limits
- - Claude Code 2.1.325 or later, in an interactive session or in an SDK or stream-json session that keeps input open. One-shot `claude -p` runs are not supported, because the process can exit before the title is applied.
- - Node.js 22.13 or later available as `node` on `PATH`. Without it the plugin stays silent and `/chat-naming status` says why.
- - Claude Code offers no compare-and-set for titles. A rename made outside the session, for example in the desktop sidebar, between the plugin's last observation and its write can be overwritten.
- - The directory lists plugins with a hooks module (a mod) for Claude Code only.
- ## Support
- Questions and bug reports: [Chat Naming support](https://pellucid.studio/chat-naming/support/). Please do not include chat transcripts, credentials or private information.
- ## Contributing and security
- Bug reports, ideas and pull requests are welcome; see [CONTRIBUTING.md](CONTRIBUTING.md). Report security problems privately as described in [SECURITY.md](SECURITY.md). Release history is in [CHANGELOG.md](CHANGELOG.md).
- ## License
- Released under the MIT License; see [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.