docs: reposition around name accuracy; scrub work-adjacent examples

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: sturimcode

.claude-plugin/marketplace.json

@@ -4,21 +4,25 @@
     "name": "sturimcode",
     "url": "https://github.com/sturimcode"
   },
-  "description": "The claude-session-namer plugin, distributed from its own repository",
+  "description": "Names Claude Code sessions more accurately and keeps the names accurate as the conversation changes.",
   "plugins": [
     {
       "name": "claude-session-namer",
       "source": "./",
-      "description": "Auto-title Claude Code sessions - and re-title them when the conversation drifts",
-      "version": "0.1.4",
+      "description": "Names Claude Code sessions more accurately and keeps the names accurate as the conversation changes.",
+      "version": "0.1.5",
       "author": {
         "name": "sturimcode",
         "url": "https://github.com/sturimcode"
       },
       "homepage": "https://github.com/sturimcode/claude-session-namer",
       "license": "MIT",
       "category": "productivity",
-      "tags": ["sessions", "titles", "hooks"]
+      "tags": [
+        "sessions",
+        "titles",
+        "hooks"
+      ]
     }
   ]
 }

.claude-plugin/plugin.json

@@ -1,14 +1,20 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "claude-session-namer",
-  "description": "Auto-title Claude Code sessions - and re-title them when the conversation drifts",
-  "version": "0.1.4",
+  "description": "Names Claude Code sessions more accurately and keeps the names accurate as the conversation changes.",
+  "version": "0.1.5",
   "author": {
     "name": "sturimcode",
     "url": "https://github.com/sturimcode"
   },
   "homepage": "https://github.com/sturimcode/claude-session-namer",
   "repository": "https://github.com/sturimcode/claude-session-namer",
   "license": "MIT",
-  "keywords": ["claude-code", "sessions", "titles", "hooks", "productivity"]
+  "keywords": [
+    "claude-code",
+    "sessions",
+    "titles",
+    "hooks",
+    "productivity"
+  ]
 }

README.md

@@ -1,8 +1,12 @@
 # claude-session-namer
 
-Automatically names your Claude Code sessions, and renames them when the conversation becomes something else.
+Keeps your Claude Code session names right - from first reply to last.
 
-Claude Code names sessions on its own, but the names are vague ("New session", "General coding session") and stay wrong once the work moves on. This fixes that: clear names, kept current, bucketed by project.
+Claude Code names each session once, early, with barely any context. The guesses are wrong as often as not, and they never change - a session that starts as a config question and becomes a three-hour refactor keeps its config-question name forever. A sidebar like that makes you open sessions just to find out what they are.
+
+This tool names a session once there's something real to name, re-reads it as the work grows, and renames it when the name has stopped being true. It can also group sessions by project (`[API] Rate limiter fix`) and put a checkmark on sessions whose work is finished - both optional. The sidebar ends up readable at a glance: what each session is, which project it belongs to, whether anything in it is still open.
+
+Names you set yourself are never touched.
 
 ## Install
 
@@ -39,7 +43,7 @@ Desktop app user? Run `claude-session-namer sidebar-setup` once and follow what
 
 Wakeups are almost always free: the hook checks one number and exits. A model call only happens when a session is new or has grown a lot since the last check - whether the growth is your messages or agent activity - so even a very long session costs about 5 haiku calls total.
 
-Titles look like `[Emails] SES bounce triage`. Prefixes are reused across sessions, so related work clusters in the sidebar. Prefer bare phrases? `claude-session-namer config prefix off`.
+Titles look like `[API] Rate limiter fix`. Prefixes are reused across sessions, so related work clusters in the sidebar. Prefer bare phrases? `claude-session-namer config prefix off`.
 
 Haiku writes the titles by default, and for an eight-word phrase it is plenty. `claude-session-namer config model sonnet` switches if you want a sharper read of a messy conversation; a sonnet call costs about 3x a haiku one.
 

package.json

@@ -1,12 +1,31 @@
 {
   "name": "claude-session-namer",
-  "version": "0.1.4",
-  "description": "Auto-title Claude Code sessions - and re-title them when the conversation drifts",
-  "bin": { "claude-session-namer": "bin/cli.js" },
-  "files": ["bin/cli.js", "src", "LICENSE"],
-  "scripts": { "test": "node --test test/*.test.js" },
-  "engines": { "node": ">=18" },
+  "version": "0.1.5",
+  "description": "Names Claude Code sessions more accurately and keeps the names accurate as the conversation changes.",
+  "bin": {
+    "claude-session-namer": "bin/cli.js"
+  },
+  "files": [
+    "bin/cli.js",
+    "src",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "license": "MIT",
-  "repository": { "type": "git", "url": "https://github.com/sturimcode/claude-session-namer" },
-  "keywords": ["claude-code", "claude", "sessions", "hooks", "productivity"]
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sturimcode/claude-session-namer"
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "sessions",
+    "hooks",
+    "productivity"
+  ]
 }

src/titler.js

@@ -11,12 +11,12 @@ const MIN_WORD_CUT_INDEX = 20;
 const PROMPT_SIGNATURE = 'You title chat sessions between a developer and a coding assistant.';
 
 const USE_PREFIX_EXAMPLES = [
-  '[Emails] SES bounce rate investigation',
-  '[Client Controls] Cascade validation rules',
+  '[API] Rate limiter investigation',
+  '[Webapp] Signup form validation',
   'KEEP',
 ];
 const BARE_PHRASE_EXAMPLES = [
-  'SES bounce rate investigation',
+  'Rate limiter investigation',
   'Cascade validation rules',
   'KEEP',
 ];