@fbincon/claude-code-statusline 3.10.0 → 3.12.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 +79 -78
  2. package/candidate.json +325 -221
  3. package/node_modules/@fbincon/statusline-cli/dist/src/help.js +1 -1
  4. package/node_modules/@fbincon/statusline-cli/dist/src/help.js.map +1 -1
  5. package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.d.ts +1 -1
  6. package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.js +7 -3
  7. package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.js.map +1 -1
  8. package/node_modules/@fbincon/statusline-cli/dist/src/integration/editor-bootstrap.d.ts +1 -0
  9. package/node_modules/@fbincon/statusline-cli/dist/src/integration/editor-bootstrap.js +41 -0
  10. package/node_modules/@fbincon/statusline-cli/dist/src/integration/editor-bootstrap.js.map +1 -0
  11. package/node_modules/@fbincon/statusline-cli/dist/src/integration/editor-worker-entry.d.ts +1 -0
  12. package/node_modules/@fbincon/statusline-cli/dist/src/integration/editor-worker-entry.js +14 -0
  13. package/node_modules/@fbincon/statusline-cli/dist/src/integration/editor-worker-entry.js.map +1 -0
  14. package/node_modules/@fbincon/statusline-cli/dist/src/main.js +14 -1
  15. package/node_modules/@fbincon/statusline-cli/dist/src/main.js.map +1 -1
  16. package/node_modules/@fbincon/statusline-cli/dist/src/management/execution-worker-entry.d.ts +1 -0
  17. package/node_modules/@fbincon/statusline-cli/dist/src/management/execution-worker-entry.js +4 -0
  18. package/node_modules/@fbincon/statusline-cli/dist/src/management/execution-worker-entry.js.map +1 -0
  19. package/node_modules/@fbincon/statusline-cli/dist/src/management/execution.d.ts +29 -0
  20. package/node_modules/@fbincon/statusline-cli/dist/src/management/execution.js +228 -0
  21. package/node_modules/@fbincon/statusline-cli/dist/src/management/execution.js.map +1 -0
  22. package/node_modules/@fbincon/statusline-cli/dist/src/management/history.d.ts +4 -0
  23. package/node_modules/@fbincon/statusline-cli/dist/src/management/history.js +150 -0
  24. package/node_modules/@fbincon/statusline-cli/dist/src/management/history.js.map +1 -0
  25. package/node_modules/@fbincon/statusline-cli/dist/src/management/inspection.d.ts +8 -0
  26. package/node_modules/@fbincon/statusline-cli/dist/src/management/inspection.js +164 -0
  27. package/node_modules/@fbincon/statusline-cli/dist/src/management/inspection.js.map +1 -0
  28. package/node_modules/@fbincon/statusline-cli/dist/src/management/mod-transition.js +2 -2
  29. package/node_modules/@fbincon/statusline-cli/dist/src/management/mod-transition.js.map +1 -1
  30. package/node_modules/@fbincon/statusline-cli/dist/src/management/restore.d.ts +14 -1
  31. package/node_modules/@fbincon/statusline-cli/dist/src/management/restore.js +2 -1
  32. package/node_modules/@fbincon/statusline-cli/dist/src/management/restore.js.map +1 -1
  33. package/node_modules/@fbincon/statusline-cli/dist/src/management/review-jobs.d.ts +16 -0
  34. package/node_modules/@fbincon/statusline-cli/dist/src/management/review-jobs.js +95 -0
  35. package/node_modules/@fbincon/statusline-cli/dist/src/management/review-jobs.js.map +1 -0
  36. package/node_modules/@fbincon/statusline-cli/dist/src/management/review-worker-entry.d.ts +1 -0
  37. package/node_modules/@fbincon/statusline-cli/dist/src/management/review-worker-entry.js +33 -0
  38. package/node_modules/@fbincon/statusline-cli/dist/src/management/review-worker-entry.js.map +1 -0
  39. package/node_modules/@fbincon/statusline-cli/dist/src/management/review.d.ts +5 -0
  40. package/node_modules/@fbincon/statusline-cli/dist/src/management/review.js +44 -0
  41. package/node_modules/@fbincon/statusline-cli/dist/src/management/review.js.map +1 -0
  42. package/node_modules/@fbincon/statusline-cli/dist/src/management/service.d.ts +6 -0
  43. package/node_modules/@fbincon/statusline-cli/dist/src/management/service.js +19 -8
  44. package/node_modules/@fbincon/statusline-cli/dist/src/management/service.js.map +1 -1
  45. package/node_modules/@fbincon/statusline-cli/dist/src/management/store.js +6 -6
  46. package/node_modules/@fbincon/statusline-cli/dist/src/management/store.js.map +1 -1
  47. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.d.ts +1 -0
  48. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.js +6 -6
  49. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.js.map +1 -1
  50. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic.js +76 -28
  51. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic.js.map +1 -1
  52. package/node_modules/@fbincon/statusline-cli/dist/src/sources/bindings.d.ts +17 -0
  53. package/node_modules/@fbincon/statusline-cli/dist/src/sources/bindings.js +176 -0
  54. package/node_modules/@fbincon/statusline-cli/dist/src/sources/bindings.js.map +1 -0
  55. package/node_modules/@fbincon/statusline-cli/dist/src/sources/command.js +11 -3
  56. package/node_modules/@fbincon/statusline-cli/dist/src/sources/command.js.map +1 -1
  57. package/node_modules/@fbincon/statusline-cli/dist/src/sources/providers.js +26 -8
  58. package/node_modules/@fbincon/statusline-cli/dist/src/sources/providers.js.map +1 -1
  59. package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.d.ts +3 -0
  60. package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.js +54 -14
  61. package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.js.map +1 -1
  62. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.d.ts +1 -0
  63. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.js +11 -4
  64. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.js.map +1 -1
  65. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/view.d.ts +3 -0
  66. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/view.js +25 -0
  67. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/view.js.map +1 -0
  68. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.d.ts +3 -3
  69. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js +59 -0
  70. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js.map +1 -1
  71. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/.claude-plugin/plugin.json +1 -1
  72. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/hooks/register.ts +92 -59
  73. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/backend.ts +3 -0
  74. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/keys.ts +6 -1
  75. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/settings.ts +1 -0
  76. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/draft.ts +6 -0
  77. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/package-manager.ts +187 -0
  78. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/package-validation.ts +52 -0
  79. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/source-manager.ts +53 -41
  80. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/source-summary.ts +22 -0
  81. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/source-validation.ts +11 -2
  82. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/task-viewer.ts +319 -0
  83. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/generated-contracts.ts +113 -5
  84. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/generated-locales.ts +7 -12392
  85. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/en.ts +2220 -0
  86. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/ja.ts +2220 -0
  87. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/ko.ts +2220 -0
  88. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-CN.ts +2220 -0
  89. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-HK.ts +2220 -0
  90. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-TW.ts +2220 -0
  91. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/resource-manifest.json +25 -15
  92. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/draw.ts +3 -1
  93. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/help.ts +1 -0
  94. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/.claude-plugin/plugin.json +1 -1
  95. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/hooks/observe.ts +10 -3
  96. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/resource-manifest.json +4 -4
  97. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.d.ts +169 -5
  98. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js +2 -2
  99. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js.map +1 -1
  100. package/node_modules/@fbincon/statusline-core/dist/src/editor/backend.js +5 -0
  101. package/node_modules/@fbincon/statusline-core/dist/src/editor/backend.js.map +1 -1
  102. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.d.ts +5 -0
  103. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js +9 -0
  104. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js.map +1 -1
  105. package/node_modules/@fbincon/statusline-core/dist/src/editor/package-manager.d.ts +49 -0
  106. package/node_modules/@fbincon/statusline-core/dist/src/editor/package-manager.js +498 -0
  107. package/node_modules/@fbincon/statusline-core/dist/src/editor/package-manager.js.map +1 -0
  108. package/node_modules/@fbincon/statusline-core/dist/src/editor/package-validation.d.ts +3 -0
  109. package/node_modules/@fbincon/statusline-core/dist/src/editor/package-validation.js +53 -0
  110. package/node_modules/@fbincon/statusline-core/dist/src/editor/package-validation.js.map +1 -0
  111. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.d.ts +9 -3
  112. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.js +74 -26
  113. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.js.map +1 -1
  114. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-summary.d.ts +5 -0
  115. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-summary.js +25 -0
  116. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-summary.js.map +1 -0
  117. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-validation.d.ts +1 -0
  118. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-validation.js +13 -2
  119. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-validation.js.map +1 -1
  120. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-viewer.d.ts +46 -0
  121. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-viewer.js +279 -0
  122. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-viewer.js.map +1 -0
  123. package/node_modules/@fbincon/statusline-core/dist/src/extensions/model.d.ts +2 -0
  124. package/node_modules/@fbincon/statusline-core/dist/src/extensions/model.js +15 -3
  125. package/node_modules/@fbincon/statusline-core/dist/src/extensions/model.js.map +1 -1
  126. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.d.ts +936 -12
  127. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js +942 -18
  128. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js.map +1 -1
  129. package/node_modules/@fbincon/statusline-core/dist/src/management/compatibility.js +1 -0
  130. package/node_modules/@fbincon/statusline-core/dist/src/management/compatibility.js.map +1 -1
  131. package/node_modules/@fbincon/statusline-core/dist/src/release.d.ts +1 -1
  132. package/node_modules/@fbincon/statusline-core/dist/src/release.js +1 -1
  133. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/en.json +157 -3
  134. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ja.json +157 -3
  135. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ko.json +157 -3
  136. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-CN.json +157 -3
  137. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-HK.json +157 -3
  138. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-TW.json +157 -3
  139. package/node_modules/@fbincon/statusline-platform/dist/src/native.d.ts +2 -0
  140. package/node_modules/@fbincon/statusline-platform/dist/src/native.js +2 -0
  141. package/node_modules/@fbincon/statusline-platform/dist/src/native.js.map +1 -1
  142. package/node_modules/@fbincon/statusline-platform/dist/src/npm.d.ts +2 -0
  143. package/node_modules/@fbincon/statusline-platform/dist/src/npm.js +20 -1
  144. package/node_modules/@fbincon/statusline-platform/dist/src/npm.js.map +1 -1
  145. package/node_modules/@fbincon/statusline-platform/dist/src/private-state.d.ts +3 -0
  146. package/node_modules/@fbincon/statusline-platform/dist/src/private-state.js +53 -0
  147. package/node_modules/@fbincon/statusline-platform/dist/src/private-state.js.map +1 -0
  148. package/node_modules/@fbincon/statusline-platform/dist/src/processes.d.ts +2 -0
  149. package/node_modules/@fbincon/statusline-platform/dist/src/processes.js +45 -0
  150. package/node_modules/@fbincon/statusline-platform/dist/src/processes.js.map +1 -1
  151. package/node_modules/@fbincon/statusline-platform/dist/src/review-worker.d.ts +4 -0
  152. package/node_modules/@fbincon/statusline-platform/dist/src/review-worker.js +22 -0
  153. package/node_modules/@fbincon/statusline-platform/dist/src/review-worker.js.map +1 -0
  154. package/node_modules/@fbincon/statusline-platform/dist/src/terminal/windows-modes.d.ts +5 -0
  155. package/node_modules/@fbincon/statusline-platform/dist/src/terminal/windows-modes.js +8 -1
  156. package/node_modules/@fbincon/statusline-platform/dist/src/terminal/windows-modes.js.map +1 -1
  157. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js +10 -0
  158. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js.map +1 -1
  159. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/presentation.js +4 -0
  160. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/presentation.js.map +1 -1
  161. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js +4 -0
  162. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js.map +1 -1
  163. package/node_modules/@fbincon/statusline-tui/dist/src/drawing.js +1 -1
  164. package/node_modules/@fbincon/statusline-tui/dist/src/drawing.js.map +1 -1
  165. package/node_modules/@fbincon/statusline-tui/dist/src/session.d.ts +5 -3
  166. package/node_modules/@fbincon/statusline-tui/dist/src/session.js +31 -8
  167. package/node_modules/@fbincon/statusline-tui/dist/src/session.js.map +1 -1
  168. package/node_modules/@fbincon/statusline-tui/dist/src/state.d.ts +1 -1
  169. package/node_modules/@fbincon/statusline-tui/dist/src/state.js +24 -1
  170. package/node_modules/@fbincon/statusline-tui/dist/src/state.js.map +1 -1
  171. package/node_modules/@fbincon/statusline-tui/dist/src/task-viewer.d.ts +6 -0
  172. package/node_modules/@fbincon/statusline-tui/dist/src/task-viewer.js +34 -0
  173. package/node_modules/@fbincon/statusline-tui/dist/src/task-viewer.js.map +1 -0
  174. package/package.json +3 -3
package/README.md CHANGED
@@ -1,14 +1,14 @@
1
1
  # Claude Code Statusline
2
2
 
3
- **English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/README.zh-CN.md)
3
+ **English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/README.zh-CN.md)
4
4
 
5
5
  [![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
6
  [npm](https://www.npmjs.com/package/@fbincon/claude-code-statusline)
7
- [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/LICENSE)
7
+ [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/LICENSE)
8
8
 
9
9
  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
10
 
11
- [Features](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md#troubleshooting)
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)
12
12
 
13
13
  <a id="phase-4-in-stable-v150"></a>
14
14
  <a id="phase-5-in-stable-v160"></a>
@@ -16,16 +16,17 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
16
16
 
17
17
  ## Features
18
18
 
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.10.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.10.0/docs/PROFILES.md).
21
- - **Inspect task evidence:** open `/statusline-task` or the CLI for task, agent, timing-source and coverage details on demand. [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/TASK_DETAILS.md).
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
22
 
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.10.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.10.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.10.0/docs/images/languages/README.md).
26
- - **Diagnose supplied input:** inspect real statusline JSON and matching saved observations without collecting or writing. See [input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/DIAGNOSTICS.md).
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).
27
28
  - **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.
28
- - **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.10.0/docs/DISPLAY_ITEMS.md#session-cost-rate).
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).
29
30
  - **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.
30
31
  - **Adjust presentation:** model and number formats, labels, built-in icons, colors, directory styles, and automatic or explicit rows with priorities and width limits.
31
32
  - **Keep Unicode intact:** joined emoji, combining marks and CJK text stay together when rows wrap, clip or appear in previews.
@@ -35,65 +36,65 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
35
36
  - **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.
36
37
  - **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.
37
38
 
38
- 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.10.0/docs/DISPLAY_ITEMS.md) for data sources and availability.
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.
39
40
 
40
41
  <a id="界面预览"></a>
41
42
 
42
43
  ## Screenshots
43
44
 
44
- [Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/images/composition/README.md).
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).
45
46
 
46
- [Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/images/README.md#discovery-and-import-review).
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).
47
48
 
48
49
 
49
- 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.10.0/docs/images/README.md).
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).
50
51
 
51
52
  <details>
52
53
  <summary>English / 简体中文 configuration</summary>
53
54
 
54
- 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.10.0/docs/images/README.md#bilingual-terminal-captures).
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).
55
56
 
56
- ![English native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/linux/languages/settings-en.png)
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)
57
58
 
58
- ![简体中文 native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/linux/languages/settings-zh-CN.png)
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)
59
60
 
60
- ![简体中文 external language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/typescript/external/linux/zh-CN/settings.png)
61
+ ![简体中文 external language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/typescript/external/linux/zh-CN/settings.png)
61
62
 
62
63
  </details>
63
64
 
64
65
  ### In-session TUI
65
66
 
66
- 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.10.0/docs/development/native.md#terminal-background-previews).
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).
67
68
 
68
69
  **Linux: Main and the status line**
69
70
 
70
- ![Linux in-session TUI Main page and actual main status line](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/linux/main.png)
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)
71
72
 
72
73
  <details>
73
74
  <summary>Linux: Subagents, Settings, Layout</summary>
74
75
 
75
76
  **Subagents: choose items and ordering for individual agent rows.**
76
77
 
77
- ![Linux in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/linux/subagents.png)
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)
78
79
 
79
80
  **Settings: adjust appearance, refresh behavior and formatting.**
80
81
 
81
- ![Linux in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/linux/settings.png)
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)
82
83
 
83
84
  **Layout: set rows, item priorities and maximum widths.**
84
85
 
85
- ![Linux in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/linux/layout.png)
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)
86
87
 
87
88
  </details>
88
89
 
89
90
  <details>
90
91
  <summary>Linux: light and dark themes</summary>
91
92
 
92
- 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.10.0/docs/images/README.md#theme-terminal-captures).
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).
93
94
 
94
- ![Linux light theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/linux/themes/main-light.png)
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)
95
96
 
96
- ![Linux dark theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/linux/themes/main-dark.png)
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)
97
98
 
98
99
  </details>
99
100
 
@@ -102,30 +103,30 @@ Earlier theme captures used a dark preview surface; the current editor offers a
102
103
 
103
104
  **Main: select and reorder main status line items.**
104
105
 
105
- ![Windows in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/windows/main.png)
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)
106
107
 
107
108
  **Subagents: choose items and ordering for individual agent rows.**
108
109
 
109
- ![Windows in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/windows/subagents.png)
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)
110
111
 
111
112
  **Settings: adjust appearance, refresh behavior and formatting.**
112
113
 
113
- ![Windows in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/windows/settings.png)
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)
114
115
 
115
116
  **Layout: set rows, item priorities and maximum widths.**
116
117
 
117
- ![Windows in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/windows/layout.png)
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)
118
119
 
119
120
  </details>
120
121
 
121
122
  <details>
122
123
  <summary>macOS: Main</summary>
123
124
 
124
- 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.10.0/docs/USER_GUIDE.md#macos-mouse-reporting-and-client-focus).
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).
125
126
 
126
127
  **Main: select and reorder main status line items.**
127
128
 
128
- ![macOS in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/native/macos/main.png)
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)
129
130
 
130
131
  </details>
131
132
 
@@ -136,19 +137,19 @@ Run `/statusline-configure` in Claude Code, or `claude-statusline configure` in
136
137
  <details>
137
138
  <summary>Linux: light/dark backgrounds and palette comparison</summary>
138
139
 
139
- 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.10.0/docs/images/README.md#external-terminal-color-captures).
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).
140
141
 
141
142
  **Light background, Palette: default**
142
143
 
143
- ![Linux light terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/linux/themes/main-light.png)
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)
144
145
 
145
146
  **Light background, Palette: ansi**
146
147
 
147
- ![Linux light terminal with ANSI palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/linux/themes/main-light-ansi.png)
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)
148
149
 
149
150
  **Dark background, Palette: default**
150
151
 
151
- ![Linux dark terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/linux/themes/main-dark.png)
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)
152
153
 
153
154
  </details>
154
155
 
@@ -157,19 +158,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
157
158
 
158
159
  **Main: select and reorder main status line items.**
159
160
 
160
- ![Linux external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/typescript/external/linux/en/main.png)
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)
161
162
 
162
163
  **Subagents: choose items and ordering for individual agent rows.**
163
164
 
164
- ![Linux external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/typescript/external/linux/en/subagents.png)
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)
165
166
 
166
167
  **Settings: adjust appearance, refresh behavior and formatting.**
167
168
 
168
- ![Linux external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/typescript/external/linux/en/settings.png)
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)
169
170
 
170
171
  **Layout: set rows, item priorities and maximum widths.**
171
172
 
172
- ![Linux external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/typescript/external/linux/en/layout.png)
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)
173
174
 
174
175
  </details>
175
176
 
@@ -178,19 +179,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
178
179
 
179
180
  **Main: select and reorder main status line items.**
180
181
 
181
- ![Windows external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/windows/main.png)
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)
182
183
 
183
184
  **Subagents: choose items and ordering for individual agent rows.**
184
185
 
185
- ![Windows external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/windows/subagents.png)
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)
186
187
 
187
188
  **Settings: adjust appearance, refresh behavior and formatting.**
188
189
 
189
- ![Windows external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/windows/settings.png)
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)
190
191
 
191
192
  **Layout: set rows, item priorities and maximum widths.**
192
193
 
193
- ![Windows external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/windows/layout.png)
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)
194
195
 
195
196
  </details>
196
197
 
@@ -199,23 +200,23 @@ Previews use the current terminal background and selected palette. Compare `ansi
199
200
 
200
201
  **Main: select and reorder main status line items.**
201
202
 
202
- ![macOS external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/macos/main.png)
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)
203
204
 
204
205
  **Subagents: choose items and ordering for individual agent rows.**
205
206
 
206
- ![macOS external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/macos/subagents.png)
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)
207
208
 
208
209
  **Settings: adjust appearance, refresh behavior and formatting.**
209
210
 
210
- ![macOS external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/macos/settings.png)
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)
211
212
 
212
213
  **Layout: set rows, item priorities and maximum widths.**
213
214
 
214
- ![macOS external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/tui/external/macos/layout.png)
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)
215
216
 
216
217
  </details>
217
218
 
218
- Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/images/archive/README.md).
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).
219
220
 
220
221
  ## Supported platforms
221
222
 
@@ -227,7 +228,7 @@ Earlier screenshots and terminal reconstructions remain in the [archive](https:/
227
228
 
228
229
  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`.
229
230
 
230
- 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.10.0/docs/USER_GUIDE.md#requirements).
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).
231
232
 
232
233
  <a id="install-current-source"></a>
233
234
  <a id="install-from-a-release-recommended"></a>
@@ -245,11 +246,11 @@ Claude Code feature requirements: subagent rows 2.1.205+; local argument-based c
245
246
 
246
247
  ## Quick installation
247
248
 
248
- 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.10.0/docs/USER_GUIDE.md#upgrading).
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).
249
250
 
250
251
  ### Install the package
251
252
 
252
- 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.10.0/docs/SETUP.md).
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).
253
254
 
254
255
  Bash, Zsh, and PowerShell:
255
256
 
@@ -270,28 +271,28 @@ claude-statusline doctor
270
271
 
271
272
  On Windows, use `claude-statusline.cmd`, or invoke the installed JavaScript entry with Node. Restart Claude Code in a trusted terminal after integration.
272
273
 
273
- 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.10.0/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
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).
274
275
 
275
276
  <details>
276
277
  <summary>Other installation methods</summary>
277
278
 
278
- Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.10.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.
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.
279
280
 
280
- Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/development/README.md#build-and-install-from-source).
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).
281
282
 
282
283
  </details>
283
284
 
284
285
  ## Common configuration
285
286
 
286
- 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.10.0/docs/USER_GUIDE.md#quick-setup-and-explanation).
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).
287
288
 
288
- [Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md#item-discovery-import-review).
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).
289
290
 
290
291
 
291
292
  | Entry point | Use |
292
293
  | --- | --- |
293
- | `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md#native-configuration-editor) |
294
- | `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
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) |
295
296
  | `claude-statusline configure` | Full TUI in the current standalone terminal |
296
297
  | `/statusline-config` | Claude question-and-answer wizard; supported argument-based commands execute locally on compatible hosts |
297
298
  | `claude-statusline config ...` | Inspect settings, set exact ordering, or configure from scripts |
@@ -309,7 +310,7 @@ claude-statusline config language reset
309
310
  claude-statusline --language en --help
310
311
  ```
311
312
 
312
- `--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.10.0/docs/USER_GUIDE.md#interface-language).
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).
313
314
 
314
315
  ### Statusline language
315
316
 
@@ -320,13 +321,13 @@ claude-statusline config set statusline-language zh-TW
320
321
  claude-statusline config set statusline-language en
321
322
  ```
322
323
 
323
- ![English statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/statusline/linux/en.png)
324
+ ![English statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/statusline/linux/en.png)
324
325
 
325
- ![Simplified Chinese statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.10.0/docs/images/statusline/linux/zh-CN.png)
326
+ ![Simplified Chinese statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.12.0/docs/images/statusline/linux/zh-CN.png)
326
327
 
327
- These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/images/README.md#statusline-language-captures).
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).
328
329
 
329
- 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.10.0/docs/USER_GUIDE.md#statusline-language).
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).
330
331
 
331
332
  ### Native configuration editor
332
333
 
@@ -346,7 +347,7 @@ claude-statusline config set directory-style home
346
347
  claude-statusline config show
347
348
  ```
348
349
 
349
- 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.10.0/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/reference/cli.md).
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).
350
351
 
351
352
  <a id="upgrade-to-v161"></a>
352
353
 
@@ -360,7 +361,7 @@ claude-statusline update
360
361
  claude-statusline doctor
361
362
  ```
362
363
 
363
- Use [package management](https://github.com/fbincon/claude-code-statusline/blob/v3.10.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.10.0/docs/USER_GUIDE.md#migrate-the-previous-distribution-name). Saved display settings, runtime state, and integration preferences remain.
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.
364
365
 
365
366
  Remove Claude integration before uninstalling the package:
366
367
 
@@ -370,7 +371,7 @@ claude-statusline uninstall
370
371
  npm uninstall --global @fbincon/claude-code-statusline
371
372
  ```
372
373
 
373
- Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md#uninstalling).
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).
374
375
 
375
376
  ## Project structure
376
377
 
@@ -429,21 +430,21 @@ claude-code-statusline/
429
430
 
430
431
  ## Documentation and help
431
432
 
432
- - [First-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/SETUP.md) · [Three complete schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/SCHEMES.md) · [Appearance controls](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/APPEARANCE.md).
433
- - [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
434
- - [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/reference/cli.md): commands, options, fields, files, and exit codes.
435
- - [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
436
- - [Development roadmap](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/development/roadmap.md) · [Work-package plan](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/development/development-plan.md).
437
- - [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/docs/RELEASING.md).
438
- - [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
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).
439
440
  - [GitHub Issues](https://github.com/fbincon/claude-code-statusline/issues): include versions, reproduction steps, and diagnostic results; remove private paths and session content.
440
441
 
441
442
  ## Contributing and security
442
443
 
443
- See the [contribution guide](https://github.com/fbincon/claude-code-statusline/blob/v3.10.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.10.0/SECURITY.md).
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).
444
445
 
445
446
  ## License
446
447
 
447
- [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
448
+ [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.12.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
448
449
 
449
- Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.10.0/tools/unicode/WCWIDTH-LICENSE.txt).
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).