@say8425/cc-statusline 3.0.0 → 3.2.0

package/README.md

@@ -54,7 +54,9 @@ Add the following to `~/.claude/settings.json`:
 - **Session Time**: Current session elapsed time
 - **Cost**: Session cost in USD
 - **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
 - **Git Diff**: File count, insertions, deletions
+- **Clickable Diff Viewer**: Click `✏️` to open a local diff viewer (Pierre `@pierre/diffs` + `@pierre/trees`) in your browser — 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
 - **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
@@ -73,13 +75,50 @@ Add the following to `~/.claude/settings.json`:
 | ⏱️    | Session elapsed time     |
 | 💰    | Session cost in USD      |
 | 🧠    | Context window usage     |
+| 🤖    | Current model and effort |
 | ⏳    | Limit reset time         |
 | 📊    | 5-hour utilization %     |
 | ⏰    | Weekly limit reset time  |
 | 📅    | 7-day utilization %      |
-| ✏️    | Uncommitted changes      |
+| ✏️    | Uncommitted changes (click to open diff viewer) |
 | 📎    | Pull request link        |
 
+## Diff Viewer
+
+Click `✏️` in the statusline to open a local diff viewer in your browser, rendered with Pierre's [`@pierre/diffs`](https://www.npmjs.com/package/@pierre/diffs) components.
+
+![diff_viewer](docs/diff_viewer.png)
+
+> [!TIP]
+> **Pairs well with [cmux](https://cmux.com)** — the viewer opens right in cmux's [browser side panel](https://cmux.com/docs/browser-automation), so your diff sits next to your terminal instead of in a separate window. cmux's built-in diff viewer felt clunky to use, which is part of why this one exists.
+
+- **Two diff modes**: `Working tree` (vs HEAD) and `vs <base>` (merge-base against the PR target or default branch). After you commit, the entry point stays alive as `✏️ vs <base>` — clicking it opens the viewer in base mode, so your diff never disappears mid-review.
+
+![diff_vs_base](docs/diff_vs_base.png)
+
+- **Image diff**: changed binary images (png/jpg/gif/webp/avif/bmp/ico) render inline in the diff flow, in the same order as the file tree — side-by-side Old/New panels on a checkerboard background, foldable like any other file
+
+![image_diff](docs/image_diff.png)
+- **Unified / Split** view toggle
+- **Watch mode**: auto-refresh (~2s polling) that detects changes while preserving scroll position
+- **File tree**: left/right placement and flatten (collapse empty directories) toggles
+- **File folding**: click any file header to collapse/expand; lockfiles and files with more than 1,500 changed lines start collapsed
+- **In-app search** (`Cmd/Ctrl+F`): searches the entire diff including deleted lines, with match navigation and highlighting
+- **Copy path**: hover a file header to copy the file's relative path
+- **Include untracked** files toggle
+
+### How It Works (Diff Viewer)
+
+The statusline spawns the viewer server on demand at `127.0.0.1:49573` whenever the repo has something to show. Requests are token-protected and bound to localhost.
+
+| Environment variable | Effect |
+| -------------------- | ------ |
+| `CC_STATUSLINE_DIFF_PORT` | Change the port (default: `49573`) |
+| `CC_STATUSLINE_DIFF_DISABLE=1` | Disable the diff viewer entirely |
+
+> [!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.
+
 ## Usage Metrics
 
 Shows usage information from Claude Code's stdin JSON input.
@@ -118,8 +157,11 @@ bun test --coverage
 # Type check
 bun run typecheck
 
-# Lint
+# Lint (oxlint, type-aware)
 bun run lint
+
+# Format (oxfmt)
+bun run format
 ```
 
 ## Color Thresholds