@say8425/cc-statusline 6.2.4 → 6.3.0

package/README.md

@@ -54,9 +54,9 @@ Add the following to `~/.claude/settings.json`:
 - **Session Time**: Current session elapsed time
 - **Cost**: Session cost in USD — hidden by default, set `CC_STATUSLINE_SHOW_COST=1` to show (see [Configuration](#configuration))
 - **Context**: Token usage with percentage (color-coded)
-- **Model**: Current model name and reasoning effort (e.g., `Fable 5 high`; effort shown only for models that support it), with an `⚡ultra` badge when ultracode is enabled in your Claude Code settings and the session reports `xhigh` effort
+- **Model**: Current model name and reasoning effort (e.g., `Fable 5 high`), with an `⚡ultra` badge in ultracode sessions
 - **Git Diff**: File count, insertions, deletions
-- **Clickable Diff Viewer**: Click `✏️` to open a local diff viewer in your browser, powered by [diffdeck](https://github.com/say8425/diffdeck) (installed automatically as a dependency) — file tree, working-tree / vs-base modes, watch mode (auto-refresh), file folding, and in-app search (`Cmd/Ctrl+F`) across the full diff, including deleted lines
+- **Clickable Diff Viewer**: Click `✏️` to open a local diff viewer in your browser (see [Diff Viewer](#diff-viewer))
 - **PR URL**: Clickable OSC 8 hyperlink
 - **Worktree Support**: Shows real project name when running in a `cc --worktree` session
 - **TrueColor**: Dynamic colors based on thresholds
@@ -64,7 +64,7 @@ Add the following to `~/.claude/settings.json`:
 - **Block Usage**: 5-hour utilization percentage
 - **Weekly Reset Timer**: Weekly limit reset time (MM/DD(Fri) HH:MM — the weekday name follows your locale)
 - **Weekly Usage**: 7-day utilization percentage
-- **Session ID**: Full session UUID at the end of the session-time line (to the right of the model segment), with no emoji label — ready to copy into `claude --resume <id>` or a log lookup
+- **Session Name**: This session's mention address, shown as `@"name"` — paste it into another Claude session to message this one
 
 ## Emoji Guide
 
@@ -77,7 +77,7 @@ Add the following to `~/.claude/settings.json`:
 | 💰    | Session cost in USD (hidden by default — see [Configuration](#configuration)) |
 | 🧠    | Context window usage     |
 | 🤖    | Current model and effort |
-| _(none)_ | Session ID — the full UUID, shown after 🤖 (or at the end of the session-time line) without an emoji label |
+| `@`   | Session name — the mention address |
 | ⏳    | Limit reset time         |
 | 📊    | 5-hour utilization %     |
 | ⏰    | Weekly limit reset time  |
@@ -139,34 +139,38 @@ Click `✏️` in the statusline to open a local diff viewer in your browser. Th
 - **diff-grab**: select code in the diff (drag the text for a character-precise selection, or use the gutter `+` for whole lines), type a prompt, and press Enter — the file path, line range, code snippet, and your prompt are copied to the clipboard, ready to paste into an agent like Claude Code
 - **Include untracked** files toggle
 
-### How It Works (Diff Viewer)
+## How It Works
 
-The statusline spawns diffdeck as a background daemon on demand at `127.0.0.1:49573` whenever the repo has something to show. Requests are token-protected and bound to localhost.
-
-The two `CC_STATUSLINE_DIFF_*` variables that control it are listed in [Configuration](#configuration).
-
-> [!TIP]
-> Open the viewer through the `✏️` link instead of a bookmark — the link always carries a fresh token and makes sure the server is running.
+Most of what the statusline shows comes from the JSON Claude Code passes on stdin — see the [official statusline docs](https://code.claude.com/docs/en/statusline) for the full schema. The few values stdin doesn't carry are read locally, as described below.
 
-## Usage Metrics
-
-Shows usage information from Claude Code's stdin JSON input.
-
-### How It Works
+### Usage Metrics
 
-Claude Code passes `rate_limits` in the stdin JSON input (CLI 2.1.80+):
+Claude Code passes `rate_limits` in the stdin JSON (CLI 2.1.80+). The usage line appears automatically whenever it is present — no flags or configuration needed:
 
 1. **5-hour utilization** - Usage percentage for the current billing block (`rate_limits.five_hour.used_percentage`)
 2. **7-day utilization** - Weekly usage percentage (`rate_limits.seven_day.used_percentage`)
 3. **Reset timer** - Exact reset time (`rate_limits.five_hour.resets_at`), shown as `HH:MM`
 4. **Weekly reset timer** - Weekly limit reset time (`rate_limits.seven_day.resets_at`), shown as `MM/DD(weekday) HH:MM`. The weekday name is localized from `LC_ALL` / `LC_TIME` / `LANG` (e.g., `02/15(Thu) 17:00` under `en_US.UTF-8`, `02/15(목) 17:00` under `ko_KR.UTF-8`). If none of the three holds a usable value — unset, empty, or `C`/`POSIX`, which mean "do not localize" — the weekday falls back to the runtime default locale (`en-US` with current Bun). macOS Terminal leaves `LANG` empty unless "Set locale environment variables on startup" is enabled
 
-Usage metrics are **automatically displayed** when `rate_limits` is present in the stdin JSON. No additional flags or configuration needed.
+> [!NOTE]
+> `rate_limits` is only available for Claude.ai subscribers (Pro/Max) after the first API response.
 
-The session ID (`session_id`) lives on the session-time line instead — see [Features](#features) — since it comes from a separate field and doesn't depend on `rate_limits`.
+### Model and Ultracode
 
-> [!NOTE]
-> `rate_limits` is only available for Claude.ai subscribers (Pro/Max) after the first API response. See the [official statusline docs](https://code.claude.com/docs/en/statusline) for the full JSON schema.
+The model name and effort come from `model.display_name` and `effort.level` (effort is sent only for models that support it). Ultracode isn't exposed on stdin, so the statusline reads the `ultracode` key from your Claude Code settings files (managed → project local → project → user) and shows `⚡ultra` only when the session also reports `xhigh` effort.
+
+### Session Name
+
+The session name is the address other Claude sessions use to message this one: the name set with `/rename` or `claude -n`, otherwise the default display name such as `my-app-3f`. stdin's `session_name` can't stand in for it — for an unnamed session it holds an AI-generated title, which isn't an address, and it never holds the default display name. The statusline therefore reads Claude Code's local session registry (`<CLAUDE_CONFIG_DIR or ~/.claude>/sessions`) and picks the entry matching `session_id`. The name is always quoted, so names with spaces or non-ASCII characters paste straight into a mention, and the segment is hidden when the registry has no entry for the session. It doesn't depend on `rate_limits`.
+
+### Diff Viewer
+
+The statusline spawns diffdeck as a background daemon on demand at `127.0.0.1:49573` whenever the repo has something to show. Requests are token-protected and bound to localhost.
+
+The two `CC_STATUSLINE_DIFF_*` variables that control it are listed in [Configuration](#configuration).
+
+> [!TIP]
+> Open the viewer through the `✏️` link instead of a bookmark — the link always carries a fresh token and makes sure the server is running.
 
 ## Dependencies
 

package/dist/index.js

@@ -560,9 +560,9 @@ var renderStatusLine = (ctx) => {
       modelText += " \u26A1ultra";
     line2 += ` | ${C.WHITE}\uD83E\uDD16 ${modelText}${C.RESET}`;
   }
-  const sessionId = ctx.claudeJson.session_id;
-  if (sessionId) {
-    line2 += ` | ${C.WHITE}${sessionId}${C.RESET}`;
+  if (ctx.sessionName) {
+    const quoted = ctx.sessionName.replaceAll('"', "\\\"");
+    line2 += ` | ${C.WHITE}@"${quoted}"${C.RESET}`;
   }
   lines.push(line2);
   const usageParts = [];
@@ -619,6 +619,42 @@ var renderStatusLine = (ctx) => {
   return lines;
 };
 
+// src/sessionName.ts
+import { readdir, readFile } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { join as join4 } from "path";
+var sessionsDir = (env = process.env, homeDir = homedir2()) => join4(env.CLAUDE_CONFIG_DIR || join4(homeDir, ".claude"), "sessions");
+var parseEntry = (content, sessionId) => {
+  try {
+    const parsed = JSON.parse(content);
+    if (typeof parsed !== "object" || parsed === null || !("sessionId" in parsed) || parsed.sessionId !== sessionId || !("name" in parsed) || typeof parsed.name !== "string") {
+      return null;
+    }
+    const name = parsed.name.trim();
+    if (!name)
+      return null;
+    const updatedAt = "updatedAt" in parsed && typeof parsed.updatedAt === "number" ? parsed.updatedAt : 0;
+    return { name, updatedAt };
+  } catch {
+    return null;
+  }
+};
+var readSessionName = async (sessionId, dir = sessionsDir()) => {
+  if (!sessionId)
+    return null;
+  let files;
+  try {
+    files = (await readdir(dir)).filter((file) => file.endsWith(".json"));
+  } catch {
+    return null;
+  }
+  const contents = await Promise.all(files.map((file) => readFile(join4(dir, file), "utf8").catch(() => null)));
+  const matches = contents.map((content) => content === null ? null : parseEntry(content, sessionId)).filter((entry) => entry !== null);
+  if (matches.length === 0)
+    return null;
+  return matches.reduce((a, b) => b.updatedAt > a.updatedAt ? b : a).name;
+};
+
 // src/stdin.ts
 var readStdin = async () => {
   const chunks = [];
@@ -629,20 +665,20 @@ var readStdin = async () => {
 };
 
 // src/ultracode.ts
-import { readFile } from "fs/promises";
-import { homedir as homedir2 } from "os";
-import { join as join4 } from "path";
-var MANAGED_SETTINGS_PATH = process.platform === "darwin" ? "/Library/Application Support/ClaudeCode/managed-settings.json" : process.platform === "win32" ? join4(process.env.ProgramData || "C:\\ProgramData", "ClaudeCode", "managed-settings.json") : "/etc/claude-code/managed-settings.json";
+import { readFile as readFile2 } from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { join as join5 } from "path";
+var MANAGED_SETTINGS_PATH = process.platform === "darwin" ? "/Library/Application Support/ClaudeCode/managed-settings.json" : process.platform === "win32" ? join5(process.env.ProgramData || "C:\\ProgramData", "ClaudeCode", "managed-settings.json") : "/etc/claude-code/managed-settings.json";
 var ultracodeSettingsPaths = (projectDir, homeDir) => {
   const paths = [MANAGED_SETTINGS_PATH];
   if (projectDir) {
-    paths.push(join4(projectDir, ".claude", "settings.local.json"), join4(projectDir, ".claude", "settings.json"));
+    paths.push(join5(projectDir, ".claude", "settings.local.json"), join5(projectDir, ".claude", "settings.json"));
   }
-  paths.push(join4(homeDir, ".claude", "settings.json"));
+  paths.push(join5(homeDir, ".claude", "settings.json"));
   return paths;
 };
 var resolveUltracodeFromFiles = async (paths) => {
-  const contents = await Promise.all(paths.map((path) => readFile(path, "utf8").catch(() => null)));
+  const contents = await Promise.all(paths.map((path) => readFile2(path, "utf8").catch(() => null)));
   for (const content of contents) {
     if (content === null)
       continue;
@@ -655,7 +691,7 @@ var resolveUltracodeFromFiles = async (paths) => {
   }
   return false;
 };
-var getUltracodeCached = async (projectDir, homeDir = homedir2()) => {
+var getUltracodeCached = async (projectDir, homeDir = homedir3()) => {
   if (Date.now() - cache.ultracode.timestamp < CACHE_TTL.ultracode) {
     return cache.ultracode.value;
   }
@@ -668,12 +704,13 @@ var getUltracodeCached = async (projectDir, homeDir = homedir2()) => {
 var main = async () => {
   const claudeJson = JSON.parse(await readStdin() || "{}");
   const repo = claudeJson.workspace?.project_dir || claudeJson.workspace?.current_dir || "";
-  const [branch, gitChanges, prInfo, mainProject, ultracode] = await Promise.all([
+  const [branch, gitChanges, prInfo, mainProject, ultracode, sessionName] = await Promise.all([
     getBranchCached(),
     getGitChangesCached(),
     getPrInfoCached(),
     getMainProjectCached(),
-    getUltracodeCached(repo)
+    getUltracodeCached(repo),
+    readSessionName(claudeJson.session_id)
   ]);
   const mainProjectName = mainProject?.name ?? null;
   const projectDirUrl = repo ? toFileUrl(repo) : null;
@@ -719,7 +756,8 @@ var main = async () => {
     baseChanges,
     baseDiffViewerUrl,
     projectDirUrl,
-    mainProjectUrl
+    mainProjectUrl,
+    sessionName
   });
   for (const line of lines) {
     console.log(line);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@say8425/cc-statusline",
-	"version": "6.2.4",
+	"version": "6.3.0",
 	"description": "Custom statusline for Claude Code",
 	"repository": {
 		"type": "git",