@fbincon/claude-code-statusline 3.12.0 → 3.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (174) hide show
  1. package/README.md +82 -79
  2. package/candidate.json +365 -286
  3. package/node_modules/@fbincon/statusline-cli/dist/src/config/arguments.d.ts +1 -0
  4. package/node_modules/@fbincon/statusline-cli/dist/src/config/arguments.js +9 -0
  5. package/node_modules/@fbincon/statusline-cli/dist/src/config/arguments.js.map +1 -1
  6. package/node_modules/@fbincon/statusline-cli/dist/src/config/commands.js +23 -0
  7. package/node_modules/@fbincon/statusline-cli/dist/src/config/commands.js.map +1 -1
  8. package/node_modules/@fbincon/statusline-cli/dist/src/config/profile-command.js +7 -3
  9. package/node_modules/@fbincon/statusline-cli/dist/src/config/profile-command.js.map +1 -1
  10. package/node_modules/@fbincon/statusline-cli/dist/src/config/reuse.d.ts +3 -0
  11. package/node_modules/@fbincon/statusline-cli/dist/src/config/reuse.js +62 -0
  12. package/node_modules/@fbincon/statusline-cli/dist/src/config/reuse.js.map +1 -0
  13. package/node_modules/@fbincon/statusline-cli/dist/src/config/structural-review.d.ts +5 -0
  14. package/node_modules/@fbincon/statusline-cli/dist/src/config/structural-review.js +45 -0
  15. package/node_modules/@fbincon/statusline-cli/dist/src/config/structural-review.js.map +1 -0
  16. package/node_modules/@fbincon/statusline-cli/dist/src/management/review-jobs.js +20 -6
  17. package/node_modules/@fbincon/statusline-cli/dist/src/management/review-jobs.js.map +1 -1
  18. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.d.ts +52 -3
  19. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js +14 -0
  20. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js.map +1 -1
  21. package/node_modules/@fbincon/statusline-cli/resources/statusline-config/SKILL.md +1 -1
  22. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/.claude-plugin/plugin.json +1 -1
  23. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/hooks/register.ts +7 -3
  24. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/backend.ts +7 -3
  25. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/keys.ts +10 -1
  26. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/settings.ts +8 -5
  27. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/alignment-manager.ts +2 -2
  28. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/change-review.ts +109 -0
  29. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/color-manager.ts +5 -4
  30. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/draft.ts +70 -21
  31. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/forms.ts +7 -13
  32. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/group-manager.ts +2 -3
  33. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/groups.ts +2 -2
  34. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/history.ts +33 -0
  35. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/import-selection.ts +2 -1
  36. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/indicators.ts +2 -2
  37. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/quick-setup.ts +1 -1
  38. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/reuse-manager.ts +150 -0
  39. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/reuse.ts +96 -0
  40. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/source-compatibility.ts +7 -0
  41. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/source-manager.ts +12 -5
  42. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/structure.ts +30 -0
  43. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/generated-contracts.ts +18 -8
  44. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/en.ts +95 -1
  45. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/ja.ts +95 -1
  46. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/ko.ts +95 -1
  47. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-CN.ts +95 -1
  48. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-HK.ts +95 -1
  49. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-TW.ts +95 -1
  50. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/presentation.ts +1 -1
  51. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/resource-manifest.json +34 -28
  52. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/draw.ts +4 -1
  53. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/help.ts +3 -2
  54. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/.claude-plugin/plugin.json +1 -1
  55. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/resource-manifest.json +3 -3
  56. package/node_modules/@fbincon/statusline-core/dist/src/config/defaults.js +1 -1
  57. package/node_modules/@fbincon/statusline-core/dist/src/config/display.d.ts +1 -1
  58. package/node_modules/@fbincon/statusline-core/dist/src/config/display.js +6 -4
  59. package/node_modules/@fbincon/statusline-core/dist/src/config/display.js.map +1 -1
  60. package/node_modules/@fbincon/statusline-core/dist/src/config/editor-fields.js +9 -0
  61. package/node_modules/@fbincon/statusline-core/dist/src/config/editor-fields.js.map +1 -1
  62. package/node_modules/@fbincon/statusline-core/dist/src/config/formatting.js +15 -3
  63. package/node_modules/@fbincon/statusline-core/dist/src/config/formatting.js.map +1 -1
  64. package/node_modules/@fbincon/statusline-core/dist/src/config/presets.d.ts +6 -1
  65. package/node_modules/@fbincon/statusline-core/dist/src/config/presets.js +5 -1
  66. package/node_modules/@fbincon/statusline-core/dist/src/config/presets.js.map +1 -1
  67. package/node_modules/@fbincon/statusline-core/dist/src/config/scenario-presets.d.ts +11 -0
  68. package/node_modules/@fbincon/statusline-core/dist/src/config/scenario-presets.js +49 -0
  69. package/node_modules/@fbincon/statusline-core/dist/src/config/scenario-presets.js.map +1 -0
  70. package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.d.ts +40 -0
  71. package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.js +1 -1
  72. package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.js.map +1 -1
  73. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.d.ts +96 -7
  74. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js +4 -3
  75. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js.map +1 -1
  76. package/node_modules/@fbincon/statusline-core/dist/src/editor/alignment-manager.js +2 -2
  77. package/node_modules/@fbincon/statusline-core/dist/src/editor/alignment-manager.js.map +1 -1
  78. package/node_modules/@fbincon/statusline-core/dist/src/editor/backend.js +9 -3
  79. package/node_modules/@fbincon/statusline-core/dist/src/editor/backend.js.map +1 -1
  80. package/node_modules/@fbincon/statusline-core/dist/src/editor/change-review.d.ts +32 -0
  81. package/node_modules/@fbincon/statusline-core/dist/src/editor/change-review.js +155 -0
  82. package/node_modules/@fbincon/statusline-core/dist/src/editor/change-review.js.map +1 -0
  83. package/node_modules/@fbincon/statusline-core/dist/src/editor/color-manager.js +6 -4
  84. package/node_modules/@fbincon/statusline-core/dist/src/editor/color-manager.js.map +1 -1
  85. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.d.ts +17 -3
  86. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js +114 -23
  87. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js.map +1 -1
  88. package/node_modules/@fbincon/statusline-core/dist/src/editor/forms.js +8 -14
  89. package/node_modules/@fbincon/statusline-core/dist/src/editor/forms.js.map +1 -1
  90. package/node_modules/@fbincon/statusline-core/dist/src/editor/group-manager.js +2 -5
  91. package/node_modules/@fbincon/statusline-core/dist/src/editor/group-manager.js.map +1 -1
  92. package/node_modules/@fbincon/statusline-core/dist/src/editor/groups.d.ts +1 -1
  93. package/node_modules/@fbincon/statusline-core/dist/src/editor/groups.js +2 -2
  94. package/node_modules/@fbincon/statusline-core/dist/src/editor/groups.js.map +1 -1
  95. package/node_modules/@fbincon/statusline-core/dist/src/editor/history.d.ts +22 -0
  96. package/node_modules/@fbincon/statusline-core/dist/src/editor/history.js +37 -0
  97. package/node_modules/@fbincon/statusline-core/dist/src/editor/history.js.map +1 -0
  98. package/node_modules/@fbincon/statusline-core/dist/src/editor/import-selection.d.ts +1 -1
  99. package/node_modules/@fbincon/statusline-core/dist/src/editor/import-selection.js +3 -1
  100. package/node_modules/@fbincon/statusline-core/dist/src/editor/import-selection.js.map +1 -1
  101. package/node_modules/@fbincon/statusline-core/dist/src/editor/indicators.js +2 -2
  102. package/node_modules/@fbincon/statusline-core/dist/src/editor/indicators.js.map +1 -1
  103. package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.js +1 -1
  104. package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.js.map +1 -1
  105. package/node_modules/@fbincon/statusline-core/dist/src/editor/reuse-manager.d.ts +39 -0
  106. package/node_modules/@fbincon/statusline-core/dist/src/editor/reuse-manager.js +271 -0
  107. package/node_modules/@fbincon/statusline-core/dist/src/editor/reuse-manager.js.map +1 -0
  108. package/node_modules/@fbincon/statusline-core/dist/src/editor/reuse.d.ts +6 -0
  109. package/node_modules/@fbincon/statusline-core/dist/src/editor/reuse.js +135 -0
  110. package/node_modules/@fbincon/statusline-core/dist/src/editor/reuse.js.map +1 -0
  111. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-compatibility.d.ts +3 -0
  112. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-compatibility.js +7 -0
  113. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-compatibility.js.map +1 -0
  114. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.js +12 -5
  115. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.js.map +1 -1
  116. package/node_modules/@fbincon/statusline-core/dist/src/editor/structure.d.ts +16 -0
  117. package/node_modules/@fbincon/statusline-core/dist/src/editor/structure.js +28 -0
  118. package/node_modules/@fbincon/statusline-core/dist/src/editor/structure.js.map +1 -0
  119. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.d.ts +564 -0
  120. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js +570 -6
  121. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js.map +1 -1
  122. package/node_modules/@fbincon/statusline-core/dist/src/release.d.ts +1 -1
  123. package/node_modules/@fbincon/statusline-core/dist/src/release.js +1 -1
  124. package/node_modules/@fbincon/statusline-core/dist/src/rendering/alignment.d.ts +1 -1
  125. package/node_modules/@fbincon/statusline-core/dist/src/rendering/alignment.js +20 -4
  126. package/node_modules/@fbincon/statusline-core/dist/src/rendering/alignment.js.map +1 -1
  127. package/node_modules/@fbincon/statusline-core/dist/src/rendering/colors.d.ts +2 -0
  128. package/node_modules/@fbincon/statusline-core/dist/src/rendering/colors.js +4 -0
  129. package/node_modules/@fbincon/statusline-core/dist/src/rendering/colors.js.map +1 -1
  130. package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.d.ts +3 -0
  131. package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.js +8 -4
  132. package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.js.map +1 -1
  133. package/node_modules/@fbincon/statusline-core/dist/src/rendering/explain.js +1 -1
  134. package/node_modules/@fbincon/statusline-core/dist/src/rendering/explain.js.map +1 -1
  135. package/node_modules/@fbincon/statusline-core/dist/src/rendering/fitting.d.ts +12 -0
  136. package/node_modules/@fbincon/statusline-core/dist/src/rendering/fitting.js +22 -0
  137. package/node_modules/@fbincon/statusline-core/dist/src/rendering/fitting.js.map +1 -0
  138. package/node_modules/@fbincon/statusline-core/dist/src/rendering/gradients.d.ts +1 -1
  139. package/node_modules/@fbincon/statusline-core/dist/src/rendering/gradients.js +9 -8
  140. package/node_modules/@fbincon/statusline-core/dist/src/rendering/gradients.js.map +1 -1
  141. package/node_modules/@fbincon/statusline-core/dist/src/rendering/groups.js +15 -6
  142. package/node_modules/@fbincon/statusline-core/dist/src/rendering/groups.js.map +1 -1
  143. package/node_modules/@fbincon/statusline-core/dist/src/rendering/indicators.d.ts +5 -0
  144. package/node_modules/@fbincon/statusline-core/dist/src/rendering/indicators.js +30 -4
  145. package/node_modules/@fbincon/statusline-core/dist/src/rendering/indicators.js.map +1 -1
  146. package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.d.ts +3 -0
  147. package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js +33 -15
  148. package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js.map +1 -1
  149. package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.d.ts +21 -1
  150. package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.js +67 -5
  151. package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.js.map +1 -1
  152. package/node_modules/@fbincon/statusline-core/dist/src/rendering/preferences.js +1 -1
  153. package/node_modules/@fbincon/statusline-core/dist/src/rendering/preferences.js.map +1 -1
  154. package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js +18 -8
  155. package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js.map +1 -1
  156. package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.d.ts +2 -0
  157. package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.js +8 -2
  158. package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.js.map +1 -1
  159. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/en.json +95 -1
  160. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ja.json +95 -1
  161. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ko.json +95 -1
  162. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-CN.json +95 -1
  163. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-HK.json +95 -1
  164. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-TW.json +95 -1
  165. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js +6 -0
  166. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js.map +1 -1
  167. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js +3 -0
  168. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js.map +1 -1
  169. package/node_modules/@fbincon/statusline-tui/dist/src/session.js +16 -1
  170. package/node_modules/@fbincon/statusline-tui/dist/src/session.js.map +1 -1
  171. package/node_modules/@fbincon/statusline-tui/dist/src/state.d.ts +1 -1
  172. package/node_modules/@fbincon/statusline-tui/dist/src/state.js +35 -9
  173. package/node_modules/@fbincon/statusline-tui/dist/src/state.js.map +1 -1
  174. package/package.json +3 -3
package/README.md CHANGED
@@ -1,14 +1,17 @@
1
1
  # Claude Code Statusline
2
2
 
3
- **English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/README.zh-CN.md)
3
+ **English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/README.zh-CN.md)
4
+
5
+
6
+ Shared undo/redo, current-file comparison, reviewed alignment repairs and selected style/whole-group reuse are described in [draft history and reuse](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/DRAFT_HISTORY.md).
4
7
 
5
8
  [![CI](https://github.com/fbincon/claude-code-statusline/actions/workflows/ci.yml/badge.svg)](https://github.com/fbincon/claude-code-statusline/actions/workflows/ci.yml)
6
9
  [npm](https://www.npmjs.com/package/@fbincon/claude-code-statusline)
7
- [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/LICENSE)
10
+ [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/LICENSE)
8
11
 
9
12
  A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reasoning effort, directory, Git, context, usage limits, tokens, and task timing at a glance. Configure the main line and individual subagent rows through an in-session editor, a terminal UI, a wizard, or the CLI.
10
13
 
11
- [Features](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#troubleshooting)
14
+ [Features](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#troubleshooting)
12
15
 
13
16
  <a id="phase-4-in-stable-v150"></a>
14
17
  <a id="phase-5-in-stable-v160"></a>
@@ -16,17 +19,17 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
16
19
 
17
20
  ## Features
18
21
 
19
- - **Add explicit data sources:** manage local JSON, GitHub checks and command values in either editor or CLI, with reviewed activation, optional session-owned GitHub refresh and directory/PR links. [Extension guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/EXTENSIONS.md).
20
- - **Reuse display schemes across projects:** save and preview named schemes, then bind project roots to complete display settings. [Profile guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/PROFILES.md).
21
- - **Inspect task evidence:** open `/statusline-task`, `task view` or the external editor to browse task evidence with search, filters and folding. [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/TASK_DETAILS.md).
22
+ - **Add explicit data sources:** manage local JSON, GitHub checks and command values in either editor or CLI, with separately reviewed activation and automatic GitHub/command refresh during active sessions, plus optional directory/PR links. [Extension guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/EXTENSIONS.md).
23
+ - **Reuse display schemes across projects:** save and preview named schemes, then bind project roots to complete display settings. [Profile guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/PROFILES.md).
24
+ - **Inspect task evidence:** open `/statusline-task`, `task view` or the external editor to browse task evidence with search, filters and folding. [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/TASK_DETAILS.md).
22
25
 
23
- - **Compose your statusline:** add, copy and arrange independent components, linked groups, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/COMPOSITION.md).
24
- - **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors, themes and short percentage bars, and opt into [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/APPEARANCE.md).
25
- - **Choose your languages:** English, 简体中文, 繁體中文, 日本語 and 한국어 for interfaces and actual statusline output, independently; interface changes save immediately, output language saves with display settings. See [language examples](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/languages/README.md).
26
- - **Review colors and samples:** press Enter on a color field for visible choices; Ctrl+V selects a sample scenario, Ctrl+W changes preview width and Ctrl+N browses rows. See [appearance](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/APPEARANCE.md#visual-color-selection-and-sample-scenarios).
27
- - **Diagnose supplied input:** press Ctrl+L in either editor to inspect a file with the unsaved draft and input-only evidence by default, or use the CLI. See [input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/DIAGNOSTICS.md).
26
+ - **Compose your statusline:** add, copy and arrange independent components, linked groups, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/COMPOSITION.md).
27
+ - **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors, themes and short percentage bars, and opt into [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/APPEARANCE.md).
28
+ - **Choose your languages:** English, 简体中文, 繁體中文, 日本語 and 한국어 for interfaces and actual statusline output, independently; interface changes save immediately, output language saves with display settings. See [language examples](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/languages/README.md).
29
+ - **Review colors and samples:** press Enter on a color field for visible choices; Ctrl+V selects a sample scenario, Ctrl+W changes preview width and Ctrl+N browses rows. See [appearance](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/APPEARANCE.md#visual-color-selection-and-sample-scenarios).
30
+ - **Diagnose supplied input:** press Ctrl+L in either editor to inspect a file with the unsaved draft and input-only evidence by default, or use the CLI. See [input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/DIAGNOSTICS.md).
28
31
  - **Find what to show:** 65 main metrics and 15 subagent metrics, plus text and flexible spacers, with ranked multilingual search, category filters and source/requirement guidance.
29
- - **Estimate session cost rates:** choose session or cumulative API time as the denominator, with a one-minute observation window and explicit units. [Metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/DISPLAY_ITEMS.md#session-cost-rate).
32
+ - **Estimate session cost rates:** choose session or cumulative API time as the denominator, with a one-minute observation window and explicit units. [Metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/DISPLAY_ITEMS.md#session-cost-rate).
30
33
  - **Track the right scope:** session token totals, per-task subagent rows, and total task time covering queueing, agents and main-agent wrap-up; optional execution time excludes verified user waits.
31
34
  - **Adjust presentation:** model and number formats, labels, built-in icons, colors, directory styles, and automatic or explicit rows with priorities and width limits.
32
35
  - **Keep Unicode intact:** joined emoji, combining marks and CJK text stay together when rows wrap, clip or appear in previews.
@@ -36,65 +39,65 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
36
39
  - **Follow terminal colors:** external TUI text and bold keys use terminal defaults, with cyan headings; previews show the selected palette on the current terminal background.
37
40
  - **Enable optional live metrics:** runtime state, agent count, tool progress, request timing, and per-task usage are opt-in. Missing or partial observations stay distinguishable.
38
41
 
39
- Rendering uses Claude Code input and local state without making network requests or using model tokens. The question-and-answer wizard uses Claude model turns. See [field definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/DISPLAY_ITEMS.md) for data sources and availability.
42
+ Rendering uses Claude Code input and local state without making network requests or using model tokens. The question-and-answer wizard uses Claude model turns. See [field definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/DISPLAY_ITEMS.md) for data sources and availability.
40
43
 
41
44
  <a id="界面预览"></a>
42
45
 
43
46
  ## Screenshots
44
47
 
45
- [Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/composition/README.md).
48
+ [Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/composition/README.md).
46
49
 
47
- [Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/README.md#discovery-and-import-review).
50
+ [Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/README.md#discovery-and-import-review).
48
51
 
49
52
 
50
- The main status line at the bottom of session screenshots shows actual data; configuration Preview regions use fixed samples. Fonts, colors and widths depend on terminal settings. [Image sources and archive](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/README.md).
53
+ The main status line at the bottom of session screenshots shows actual data; configuration Preview regions use fixed samples. Fonts, colors and widths depend on terminal settings. [Image sources and archive](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/README.md).
51
54
 
52
55
  <details>
53
56
  <summary>English / 简体中文 configuration</summary>
54
57
 
55
- Linux terminal captures show the shared language selector and Chinese interface. These are reconstructions of actual PTY cells with sample previews; [sources and all pages](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/README.md#bilingual-terminal-captures).
58
+ Linux terminal captures show the shared language selector and Chinese interface. These are reconstructions of actual PTY cells with sample previews; [sources and all pages](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/README.md#bilingual-terminal-captures).
56
59
 
57
- ![English native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/linux/languages/settings-en.png)
60
+ ![English native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/linux/languages/settings-en.png)
58
61
 
59
- ![简体中文 native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/linux/languages/settings-zh-CN.png)
62
+ ![简体中文 native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/linux/languages/settings-zh-CN.png)
60
63
 
61
- ![简体中文 external language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/typescript/external/linux/zh-CN/settings.png)
64
+ ![简体中文 external language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/typescript/external/linux/zh-CN/settings.png)
62
65
 
63
66
  </details>
64
67
 
65
68
  ### In-session TUI
66
69
 
67
- Run `/statusline-configure-native` inside the current Claude Code session, then click the Client region once before using the keyboard. The editor follows the Claude theme; choose the preview background to match the terminal and compare the selected palette. [Compare terminal/theme combinations](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/development/native.md#terminal-background-previews).
70
+ Run `/statusline-configure-native` inside the current Claude Code session, then click the Client region once before using the keyboard. The editor follows the Claude theme; choose the preview background to match the terminal and compare the selected palette. [Compare terminal/theme combinations](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/development/native.md#terminal-background-previews).
68
71
 
69
72
  **Linux: Main and the status line**
70
73
 
71
- ![Linux in-session TUI Main page and actual main status line](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/linux/main.png)
74
+ ![Linux in-session TUI Main page and actual main status line](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/linux/main.png)
72
75
 
73
76
  <details>
74
77
  <summary>Linux: Subagents, Settings, Layout</summary>
75
78
 
76
79
  **Subagents: choose items and ordering for individual agent rows.**
77
80
 
78
- ![Linux in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/linux/subagents.png)
81
+ ![Linux in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/linux/subagents.png)
79
82
 
80
83
  **Settings: adjust appearance, refresh behavior and formatting.**
81
84
 
82
- ![Linux in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/linux/settings.png)
85
+ ![Linux in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/linux/settings.png)
83
86
 
84
87
  **Layout: set rows, item priorities and maximum widths.**
85
88
 
86
- ![Linux in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/linux/layout.png)
89
+ ![Linux in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/linux/layout.png)
87
90
 
88
91
  </details>
89
92
 
90
93
  <details>
91
94
  <summary>Linux: light and dark themes</summary>
92
95
 
93
- Earlier theme captures used a dark preview surface; the current editor offers a separate light/dark preview choice. These images reconstruct real terminal cells. [Capture provenance](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/README.md#theme-terminal-captures).
96
+ Earlier theme captures used a dark preview surface; the current editor offers a separate light/dark preview choice. These images reconstruct real terminal cells. [Capture provenance](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/README.md#theme-terminal-captures).
94
97
 
95
- ![Linux light theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/linux/themes/main-light.png)
98
+ ![Linux light theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/linux/themes/main-light.png)
96
99
 
97
- ![Linux dark theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/linux/themes/main-dark.png)
100
+ ![Linux dark theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/linux/themes/main-dark.png)
98
101
 
99
102
  </details>
100
103
 
@@ -103,30 +106,30 @@ Earlier theme captures used a dark preview surface; the current editor offers a
103
106
 
104
107
  **Main: select and reorder main status line items.**
105
108
 
106
- ![Windows in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/windows/main.png)
109
+ ![Windows in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/windows/main.png)
107
110
 
108
111
  **Subagents: choose items and ordering for individual agent rows.**
109
112
 
110
- ![Windows in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/windows/subagents.png)
113
+ ![Windows in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/windows/subagents.png)
111
114
 
112
115
  **Settings: adjust appearance, refresh behavior and formatting.**
113
116
 
114
- ![Windows in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/windows/settings.png)
117
+ ![Windows in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/windows/settings.png)
115
118
 
116
119
  **Layout: set rows, item priorities and maximum widths.**
117
120
 
118
- ![Windows in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/windows/layout.png)
121
+ ![Windows in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/windows/layout.png)
119
122
 
120
123
  </details>
121
124
 
122
125
  <details>
123
126
  <summary>macOS: Main</summary>
124
127
 
125
- Only Main was supplied for this batch. The existing interaction limitation and checks are documented in [macOS mouse reporting and Client focus](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#macos-mouse-reporting-and-client-focus).
128
+ Only Main was supplied for this batch. The existing interaction limitation and checks are documented in [macOS mouse reporting and Client focus](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#macos-mouse-reporting-and-client-focus).
126
129
 
127
130
  **Main: select and reorder main status line items.**
128
131
 
129
- ![macOS in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/native/macos/main.png)
132
+ ![macOS in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/native/macos/main.png)
130
133
 
131
134
  </details>
132
135
 
@@ -137,19 +140,19 @@ Run `/statusline-configure` in Claude Code, or `claude-statusline configure` in
137
140
  <details>
138
141
  <summary>Linux: light/dark backgrounds and palette comparison</summary>
139
142
 
140
- Previews use the current terminal background and selected palette. Compare `ansi` in Settings when `default` looks faint. These are terminal-output reconstructions from dedicated GNOME profiles; [capture sources](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/README.md#external-terminal-color-captures).
143
+ Previews use the current terminal background and selected palette. Compare `ansi` in Settings when `default` looks faint. These are terminal-output reconstructions from dedicated GNOME profiles; [capture sources](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/README.md#external-terminal-color-captures).
141
144
 
142
145
  **Light background, Palette: default**
143
146
 
144
- ![Linux light terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/linux/themes/main-light.png)
147
+ ![Linux light terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/linux/themes/main-light.png)
145
148
 
146
149
  **Light background, Palette: ansi**
147
150
 
148
- ![Linux light terminal with ANSI palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/linux/themes/main-light-ansi.png)
151
+ ![Linux light terminal with ANSI palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/linux/themes/main-light-ansi.png)
149
152
 
150
153
  **Dark background, Palette: default**
151
154
 
152
- ![Linux dark terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/linux/themes/main-dark.png)
155
+ ![Linux dark terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/linux/themes/main-dark.png)
153
156
 
154
157
  </details>
155
158
 
@@ -158,19 +161,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
158
161
 
159
162
  **Main: select and reorder main status line items.**
160
163
 
161
- ![Linux external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/typescript/external/linux/en/main.png)
164
+ ![Linux external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/typescript/external/linux/en/main.png)
162
165
 
163
166
  **Subagents: choose items and ordering for individual agent rows.**
164
167
 
165
- ![Linux external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/typescript/external/linux/en/subagents.png)
168
+ ![Linux external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/typescript/external/linux/en/subagents.png)
166
169
 
167
170
  **Settings: adjust appearance, refresh behavior and formatting.**
168
171
 
169
- ![Linux external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/typescript/external/linux/en/settings.png)
172
+ ![Linux external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/typescript/external/linux/en/settings.png)
170
173
 
171
174
  **Layout: set rows, item priorities and maximum widths.**
172
175
 
173
- ![Linux external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/typescript/external/linux/en/layout.png)
176
+ ![Linux external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/typescript/external/linux/en/layout.png)
174
177
 
175
178
  </details>
176
179
 
@@ -179,19 +182,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
179
182
 
180
183
  **Main: select and reorder main status line items.**
181
184
 
182
- ![Windows external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/windows/main.png)
185
+ ![Windows external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/windows/main.png)
183
186
 
184
187
  **Subagents: choose items and ordering for individual agent rows.**
185
188
 
186
- ![Windows external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/windows/subagents.png)
189
+ ![Windows external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/windows/subagents.png)
187
190
 
188
191
  **Settings: adjust appearance, refresh behavior and formatting.**
189
192
 
190
- ![Windows external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/windows/settings.png)
193
+ ![Windows external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/windows/settings.png)
191
194
 
192
195
  **Layout: set rows, item priorities and maximum widths.**
193
196
 
194
- ![Windows external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/windows/layout.png)
197
+ ![Windows external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/windows/layout.png)
195
198
 
196
199
  </details>
197
200
 
@@ -200,23 +203,23 @@ Previews use the current terminal background and selected palette. Compare `ansi
200
203
 
201
204
  **Main: select and reorder main status line items.**
202
205
 
203
- ![macOS external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/macos/main.png)
206
+ ![macOS external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/macos/main.png)
204
207
 
205
208
  **Subagents: choose items and ordering for individual agent rows.**
206
209
 
207
- ![macOS external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/macos/subagents.png)
210
+ ![macOS external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/macos/subagents.png)
208
211
 
209
212
  **Settings: adjust appearance, refresh behavior and formatting.**
210
213
 
211
- ![macOS external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/macos/settings.png)
214
+ ![macOS external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/macos/settings.png)
212
215
 
213
216
  **Layout: set rows, item priorities and maximum widths.**
214
217
 
215
- ![macOS external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/tui/external/macos/layout.png)
218
+ ![macOS external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/tui/external/macos/layout.png)
216
219
 
217
220
  </details>
218
221
 
219
- Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/archive/README.md).
222
+ Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/archive/README.md).
220
223
 
221
224
  ## Supported platforms
222
225
 
@@ -228,7 +231,7 @@ Earlier screenshots and terminal reconstructions remain in the [archive](https:/
228
231
 
229
232
  Windows ARM devices use x64 Node under emulation; native Windows ARM64 and 32-bit runtimes are outside the current support contract. Git information requires `git`.
230
233
 
231
- Claude Code feature requirements: subagent rows 2.1.205+; local argument-based configuration and external TUI entry 2.1.258+; in-session Client 2.1.287+; native timing and advanced live-metrics collection 2.1.289+. Unsupported or unknown host versions suspend the corresponding integration. See [requirements](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#requirements).
234
+ Claude Code feature requirements: subagent rows 2.1.205+; local argument-based configuration and external TUI entry 2.1.258+; in-session Client 2.1.287+; native timing and advanced live-metrics collection 2.1.289+. Unsupported or unknown host versions suspend the corresponding integration. See [requirements](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#requirements).
232
235
 
233
236
  <a id="install-current-source"></a>
234
237
  <a id="install-from-a-release-recommended"></a>
@@ -246,11 +249,11 @@ Claude Code feature requirements: subagent rows 2.1.205+; local argument-based c
246
249
 
247
250
  ## Quick installation
248
251
 
249
- Install Node 22.x or 24.x with npm and Claude Code CLI. One npm package includes the supported native dependencies and needs no Python or compiler. [Existing Python installation and rollback](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#upgrading).
252
+ Install Node 22.x or 24.x with npm and Claude Code CLI. One npm package includes the supported native dependencies and needs no Python or compiler. [Existing Python installation and rollback](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#upgrading).
250
253
 
251
254
  ### Install the package
252
255
 
253
- For a reviewed installation in an interactive terminal, run `npx @fbincon/claude-code-statusline`. It verifies the durable global entry before opening setup. An installed `claude-statusline` without a subcommand opens the same flow. [Installation stages](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/SETUP.md).
256
+ For a reviewed installation in an interactive terminal, run `npx @fbincon/claude-code-statusline`. It verifies the durable global entry before opening setup. An installed `claude-statusline` without a subcommand opens the same flow. [Installation stages](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/SETUP.md).
254
257
 
255
258
  Bash, Zsh, and PowerShell:
256
259
 
@@ -271,28 +274,28 @@ claude-statusline doctor
271
274
 
272
275
  On Windows, use `claude-statusline.cmd`, or invoke the installed JavaScript entry with Node. Restart Claude Code in a trusted terminal after integration.
273
276
 
274
- Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing and advanced live metrics both require explicit opt-in on compatible hosts; saved choices are preserved. Package installation and Claude integration are separate steps. `setup` connects checks, scheme preview and integration review; `install` remains the direct integration command. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
277
+ Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing and advanced live metrics both require explicit opt-in on compatible hosts; saved choices are preserved. Package installation and Claude integration are separate steps. `setup` connects checks, scheme preview and integration review; `install` remains the direct integration command. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
275
278
 
276
279
  <details>
277
280
  <summary>Other installation methods</summary>
278
281
 
279
- Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/development/README.md#build-and-install-from-source). Release attachments support offline npm installation; the installation guide covers fixed versions and Python recovery.
282
+ Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/development/README.md#build-and-install-from-source). Release attachments support offline npm installation; the installation guide covers fixed versions and Python recovery.
280
283
 
281
- Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/development/README.md#build-and-install-from-source).
284
+ Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/development/README.md#build-and-install-from-source).
282
285
 
283
286
  </details>
284
287
 
285
288
  ## Common configuration
286
289
 
287
- In either editor, use **Ctrl+P** or **Settings → Quick setup** to choose a use case, appearance and sample before editing or saving. Text fields support grapheme cursor editing. Item details explain configuration, requirements and sample fitting. See [quick setup and explanation](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#quick-setup-and-explanation).
290
+ In either editor, use **Ctrl+P** or **Settings → Quick setup** to choose a use case, appearance and sample before editing or saving. Text fields support grapheme cursor editing. Item details explain configuration, requirements and sample fitting. See [quick setup and explanation](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#quick-setup-and-explanation).
288
291
 
289
- [Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#item-discovery-import-review).
292
+ [Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#item-discovery-import-review).
290
293
 
291
294
 
292
295
  | Entry point | Use |
293
296
  | --- | --- |
294
- | `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#native-configuration-editor) |
295
- | `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
297
+ | `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#native-configuration-editor) |
298
+ | `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
296
299
  | `claude-statusline configure` | Full TUI in the current standalone terminal |
297
300
  | `/statusline-config` | Claude question-and-answer wizard; supported argument-based commands execute locally on compatible hosts |
298
301
  | `claude-statusline config ...` | Inspect settings, set exact ordering, or configure from scripts |
@@ -310,7 +313,7 @@ claude-statusline config language reset
310
313
  claude-statusline --language en --help
311
314
  ```
312
315
 
313
- `--language en|zh-CN|zh-TW|zh-HK|ja|ko` precedes the command and affects only that invocation; for `configure` it sets the initial language. Commands, IDs, configuration values and custom text retain their values. Interface language does not change output language. See [language settings](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#interface-language).
316
+ `--language en|zh-CN|zh-TW|zh-HK|ja|ko` precedes the command and affects only that invocation; for `configure` it sets the initial language. Commands, IDs, configuration values and custom text retain their values. Interface language does not change output language. See [language settings](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#interface-language).
314
317
 
315
318
  ### Statusline language
316
319
 
@@ -321,13 +324,13 @@ claude-statusline config set statusline-language zh-TW
321
324
  claude-statusline config set statusline-language en
322
325
  ```
323
326
 
324
- ![English statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/statusline/linux/en.png)
327
+ ![English statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/statusline/linux/en.png)
325
328
 
326
- ![Simplified Chinese statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/statusline/linux/zh-CN.png)
329
+ ![Simplified Chinese statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.14.0/docs/images/statusline/linux/zh-CN.png)
327
330
 
328
- These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/images/README.md#statusline-language-captures).
331
+ These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/images/README.md#statusline-language-captures).
329
332
 
330
- Built-in labels and known states are translated. Technical units, model names, branches, paths and custom text are preserved. See [output language](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#statusline-language).
333
+ Built-in labels and known states are translated. Technical units, model names, branches, paths and custom text are preserved. See [output language](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#statusline-language).
331
334
 
332
335
  ### Native configuration editor
333
336
 
@@ -347,7 +350,7 @@ claude-statusline config set directory-style home
347
350
  claude-statusline config show
348
351
  ```
349
352
 
350
- Configuration is per user. `set-items` replaces the enabled set; `enable` and `disable` make incremental changes. See [recipes](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/reference/cli.md).
353
+ Configuration is per user. `set-items` replaces the enabled set; `enable` and `disable` make incremental changes. See [recipes](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/reference/cli.md).
351
354
 
352
355
  <a id="upgrade-to-v161"></a>
353
356
 
@@ -361,7 +364,7 @@ claude-statusline update
361
364
  claude-statusline doctor
362
365
  ```
363
366
 
364
- Use [package management](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/PACKAGE_MANAGEMENT.md) for exact versions, prefixes, rollback and separate configuration restoration. Existing Python installations should first follow the [migration and rollback procedure](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#migrate-the-previous-distribution-name). Saved display settings, runtime state, and integration preferences remain.
367
+ Use [package management](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/PACKAGE_MANAGEMENT.md) for exact versions, prefixes, rollback and separate configuration restoration. Existing Python installations should first follow the [migration and rollback procedure](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#migrate-the-previous-distribution-name). Saved display settings, runtime state, and integration preferences remain.
365
368
 
366
369
  Remove Claude integration before uninstalling the package:
367
370
 
@@ -371,7 +374,7 @@ claude-statusline uninstall
371
374
  npm uninstall --global @fbincon/claude-code-statusline
372
375
  ```
373
376
 
374
- Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md#uninstalling).
377
+ Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md#uninstalling).
375
378
 
376
379
  ## Project structure
377
380
 
@@ -430,21 +433,21 @@ claude-code-statusline/
430
433
 
431
434
  ## Documentation and help
432
435
 
433
- - [First-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/SETUP.md) · [Three complete schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/SCHEMES.md) · [Appearance controls](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/APPEARANCE.md).
434
- - [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
435
- - [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/reference/cli.md): commands, options, fields, files, and exit codes.
436
- - [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
437
- - [Development roadmap](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/development/roadmap.md) · [Work-package plan](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/development/development-plan.md).
438
- - [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/docs/RELEASING.md).
439
- - [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
436
+ - [First-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/SETUP.md) · [Three complete schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/SCHEMES.md) · [Appearance controls](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/APPEARANCE.md).
437
+ - [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
438
+ - [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/reference/cli.md): commands, options, fields, files, and exit codes.
439
+ - [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
440
+ - [Development roadmap](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/development/roadmap.md) · [Work-package plan](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/development/development-plan.md).
441
+ - [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/docs/RELEASING.md).
442
+ - [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
440
443
  - [GitHub Issues](https://github.com/fbincon/claude-code-statusline/issues): include versions, reproduction steps, and diagnostic results; remove private paths and session content.
441
444
 
442
445
  ## Contributing and security
443
446
 
444
- See the [contribution guide](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/CONTRIBUTING.md) for development, translations and feedback. Report potential vulnerabilities privately using the [security policy](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/SECURITY.md).
447
+ See the [contribution guide](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/CONTRIBUTING.md) for development, translations and feedback. Report potential vulnerabilities privately using the [security policy](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/SECURITY.md).
445
448
 
446
449
  ## License
447
450
 
448
- [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
451
+ [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
449
452
 
450
- Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/tools/unicode/WCWIDTH-LICENSE.txt).
453
+ Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.14.0/tools/unicode/WCWIDTH-LICENSE.txt).