@fbincon/claude-code-statusline 3.2.0 → 3.4.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 (172) hide show
  1. package/README.md +74 -70
  2. package/candidate.json +287 -211
  3. package/node_modules/@fbincon/statusline-cli/dist/src/config/profile-command.d.ts +12 -0
  4. package/node_modules/@fbincon/statusline-cli/dist/src/config/profile-command.js +101 -0
  5. package/node_modules/@fbincon/statusline-cli/dist/src/config/profile-command.js.map +1 -0
  6. package/node_modules/@fbincon/statusline-cli/dist/src/config/profiles.d.ts +54 -0
  7. package/node_modules/@fbincon/statusline-cli/dist/src/config/profiles.js +199 -0
  8. package/node_modules/@fbincon/statusline-cli/dist/src/config/profiles.js.map +1 -0
  9. package/node_modules/@fbincon/statusline-cli/dist/src/config/service.js +5 -1
  10. package/node_modules/@fbincon/statusline-cli/dist/src/config/service.js.map +1 -1
  11. package/node_modules/@fbincon/statusline-cli/dist/src/config/transfer.d.ts +1 -0
  12. package/node_modules/@fbincon/statusline-cli/dist/src/config/transfer.js +4 -1
  13. package/node_modules/@fbincon/statusline-cli/dist/src/config/transfer.js.map +1 -1
  14. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/command.d.ts +10 -0
  15. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/command.js +107 -0
  16. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/command.js.map +1 -0
  17. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/observations.d.ts +8 -0
  18. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/observations.js +233 -0
  19. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/observations.js.map +1 -0
  20. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.d.ts +18 -0
  21. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.js +68 -0
  22. package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.js.map +1 -0
  23. package/node_modules/@fbincon/statusline-cli/dist/src/help.js +13 -1
  24. package/node_modules/@fbincon/statusline-cli/dist/src/help.js.map +1 -1
  25. package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.d.ts +2 -1
  26. package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.js +3 -1
  27. package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.js.map +1 -1
  28. package/node_modules/@fbincon/statusline-cli/dist/src/integration/install.js +4 -1
  29. package/node_modules/@fbincon/statusline-cli/dist/src/integration/install.js.map +1 -1
  30. package/node_modules/@fbincon/statusline-cli/dist/src/main.js +38 -9
  31. package/node_modules/@fbincon/statusline-cli/dist/src/main.js.map +1 -1
  32. package/node_modules/@fbincon/statusline-cli/dist/src/recovery/journal.js +1 -1
  33. package/node_modules/@fbincon/statusline-cli/dist/src/recovery/journal.js.map +1 -1
  34. package/node_modules/@fbincon/statusline-cli/dist/src/rendering/configuration.d.ts +12 -0
  35. package/node_modules/@fbincon/statusline-cli/dist/src/rendering/configuration.js +59 -0
  36. package/node_modules/@fbincon/statusline-cli/dist/src/rendering/configuration.js.map +1 -0
  37. package/node_modules/@fbincon/statusline-cli/dist/src/rendering/main.js +15 -2
  38. package/node_modules/@fbincon/statusline-cli/dist/src/rendering/main.js.map +1 -1
  39. package/node_modules/@fbincon/statusline-cli/dist/src/runtime/usage.d.ts +1 -1
  40. package/node_modules/@fbincon/statusline-cli/dist/src/runtime/usage.js +1 -8
  41. package/node_modules/@fbincon/statusline-cli/dist/src/runtime/usage.js.map +1 -1
  42. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.d.ts +3 -0
  43. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.js +25 -0
  44. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.js.map +1 -0
  45. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/service.d.ts +4 -0
  46. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/service.js +93 -0
  47. package/node_modules/@fbincon/statusline-cli/dist/src/tasks/service.js.map +1 -0
  48. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.d.ts +8 -4
  49. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js +41 -9
  50. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js.map +1 -1
  51. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/.claude-plugin/plugin.json +1 -1
  52. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/hooks/register.ts +89 -3
  53. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/backend.ts +78 -4
  54. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/keys.ts +8 -1
  55. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/settings.ts +1 -0
  56. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/draft.ts +2 -0
  57. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/profile-manager.ts +239 -0
  58. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/task-detail.ts +27 -0
  59. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/generated-contracts.ts +93 -5
  60. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/generated-locales.ts +1152 -12
  61. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/session.ts +2 -1
  62. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/resource-manifest.json +16 -14
  63. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/draw.ts +6 -2
  64. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/help.ts +1 -0
  65. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/.claude-plugin/plugin.json +1 -1
  66. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/resource-manifest.json +3 -3
  67. package/node_modules/@fbincon/statusline-core/dist/src/config/catalog-data.js +46 -4
  68. package/node_modules/@fbincon/statusline-core/dist/src/config/catalog-data.js.map +1 -1
  69. package/node_modules/@fbincon/statusline-core/dist/src/config/profiles.d.ts +16 -0
  70. package/node_modules/@fbincon/statusline-core/dist/src/config/profiles.js +69 -0
  71. package/node_modules/@fbincon/statusline-core/dist/src/config/profiles.js.map +1 -0
  72. package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.d.ts +1 -1
  73. package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.js +1 -1
  74. package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.js.map +1 -1
  75. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.d.ts +144 -4
  76. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js +3 -1
  77. package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js.map +1 -1
  78. package/node_modules/@fbincon/statusline-core/dist/src/editor/backend.js +100 -4
  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/draft.d.ts +2 -0
  81. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js +1 -0
  82. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js.map +1 -1
  83. package/node_modules/@fbincon/statusline-core/dist/src/editor/profile-manager.d.ts +60 -0
  84. package/node_modules/@fbincon/statusline-core/dist/src/editor/profile-manager.js +330 -0
  85. package/node_modules/@fbincon/statusline-core/dist/src/editor/profile-manager.js.map +1 -0
  86. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-detail.d.ts +4 -0
  87. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-detail.js +25 -0
  88. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-detail.js.map +1 -0
  89. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.d.ts +1146 -6
  90. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js +1152 -12
  91. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js.map +1 -1
  92. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/en.d.ts +9 -0
  93. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/en.js +10 -1
  94. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/en.js.map +1 -1
  95. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ja.d.ts +9 -0
  96. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ja.js +10 -1
  97. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ja.js.map +1 -1
  98. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ko.d.ts +9 -0
  99. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ko.js +10 -1
  100. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ko.js.map +1 -1
  101. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-CN.d.ts +9 -0
  102. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-CN.js +10 -1
  103. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-CN.js.map +1 -1
  104. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-HK.d.ts +9 -0
  105. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-HK.js +10 -1
  106. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-HK.js.map +1 -1
  107. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-TW.d.ts +9 -0
  108. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-TW.js +10 -1
  109. package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-TW.js.map +1 -1
  110. package/node_modules/@fbincon/statusline-core/dist/src/release.d.ts +1 -1
  111. package/node_modules/@fbincon/statusline-core/dist/src/release.js +1 -1
  112. package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.js +2 -2
  113. package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.js.map +1 -1
  114. package/node_modules/@fbincon/statusline-core/dist/src/rendering/context.d.ts +5 -3
  115. package/node_modules/@fbincon/statusline-core/dist/src/rendering/diagnose.d.ts +15 -0
  116. package/node_modules/@fbincon/statusline-core/dist/src/rendering/diagnose.js +110 -0
  117. package/node_modules/@fbincon/statusline-core/dist/src/rendering/diagnose.js.map +1 -0
  118. package/node_modules/@fbincon/statusline-core/dist/src/rendering/explain.d.ts +2 -1
  119. package/node_modules/@fbincon/statusline-core/dist/src/rendering/explain.js +23 -18
  120. package/node_modules/@fbincon/statusline-core/dist/src/rendering/explain.js.map +1 -1
  121. package/node_modules/@fbincon/statusline-core/dist/src/rendering/host-fields.d.ts +18 -0
  122. package/node_modules/@fbincon/statusline-core/dist/src/rendering/host-fields.js +54 -0
  123. package/node_modules/@fbincon/statusline-core/dist/src/rendering/host-fields.js.map +1 -0
  124. package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js +15 -12
  125. package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js.map +1 -1
  126. package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.js +2 -2
  127. package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.js.map +1 -1
  128. package/node_modules/@fbincon/statusline-core/dist/src/rendering/preview.js +1 -1
  129. package/node_modules/@fbincon/statusline-core/dist/src/rendering/preview.js.map +1 -1
  130. package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js +11 -11
  131. package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js.map +1 -1
  132. package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.d.ts +4 -3
  133. package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.js +5 -4
  134. package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.js.map +1 -1
  135. package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/requests.d.ts +2 -0
  136. package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/requests.js +4 -0
  137. package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/requests.js.map +1 -1
  138. package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/snapshot.d.ts +3 -1
  139. package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/snapshot.js +11 -4
  140. package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/snapshot.js.map +1 -1
  141. package/node_modules/@fbincon/statusline-core/dist/src/runtime/tasks/details.d.ts +24 -0
  142. package/node_modules/@fbincon/statusline-core/dist/src/runtime/tasks/details.js +153 -0
  143. package/node_modules/@fbincon/statusline-core/dist/src/runtime/tasks/details.js.map +1 -0
  144. package/node_modules/@fbincon/statusline-core/dist/src/runtime/usage.d.ts +2 -0
  145. package/node_modules/@fbincon/statusline-core/dist/src/runtime/usage.js +9 -0
  146. package/node_modules/@fbincon/statusline-core/dist/src/runtime/usage.js.map +1 -1
  147. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/en.json +192 -2
  148. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ja.json +192 -2
  149. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ko.json +192 -2
  150. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-CN.json +192 -2
  151. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-HK.json +192 -2
  152. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-TW.json +192 -2
  153. package/node_modules/@fbincon/statusline-platform/dist/src/diagnostic-files.d.ts +7 -0
  154. package/node_modules/@fbincon/statusline-platform/dist/src/diagnostic-files.js +29 -0
  155. package/node_modules/@fbincon/statusline-platform/dist/src/diagnostic-files.js.map +1 -0
  156. package/node_modules/@fbincon/statusline-platform/dist/src/project-paths.d.ts +8 -0
  157. package/node_modules/@fbincon/statusline-platform/dist/src/project-paths.js +41 -0
  158. package/node_modules/@fbincon/statusline-platform/dist/src/project-paths.js.map +1 -0
  159. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js +5 -0
  160. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js.map +1 -1
  161. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/presentation.js +2 -0
  162. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/presentation.js.map +1 -1
  163. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js +2 -0
  164. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js.map +1 -1
  165. package/node_modules/@fbincon/statusline-tui/dist/src/drawing.js +3 -2
  166. package/node_modules/@fbincon/statusline-tui/dist/src/drawing.js.map +1 -1
  167. package/node_modules/@fbincon/statusline-tui/dist/src/session.js +7 -3
  168. package/node_modules/@fbincon/statusline-tui/dist/src/session.js.map +1 -1
  169. package/node_modules/@fbincon/statusline-tui/dist/src/state.d.ts +1 -1
  170. package/node_modules/@fbincon/statusline-tui/dist/src/state.js +18 -2
  171. package/node_modules/@fbincon/statusline-tui/dist/src/state.js.map +1 -1
  172. package/package.json +1 -1
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.2.0/README.zh-CN.md)
3
+ **English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.4.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.2.0/LICENSE)
7
+ [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.4.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.2.0/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#troubleshooting)
11
+ [Features](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.4.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,10 +16,14 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
16
16
 
17
17
  ## Features
18
18
 
19
- - **Compose your statusline:** add, copy and arrange independent components, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/COMPOSITION.md).
20
- - **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors and themes, and opt into basic [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/APPEARANCE.md).
21
- - **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.2.0/docs/images/languages/README.md).
22
- - **Find what to show:** 60 main metrics and 14 subagent metrics, plus text and flexible spacers, with ranked multilingual search, category filters and source/requirement guidance.
19
+ - **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.4.0/docs/PROFILES.md).
20
+ - **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.4.0/docs/TASK_DETAILS.md).
21
+
22
+ - **Compose your statusline:** add, copy and arrange independent components, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/COMPOSITION.md).
23
+ - **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors and themes, and opt into basic [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/APPEARANCE.md).
24
+ - **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.4.0/docs/images/languages/README.md).
25
+ - **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.4.0/docs/DIAGNOSTICS.md).
26
+ - **Find what to show:** 61 main metrics and 14 subagent metrics, plus text and flexible spacers, with ranked multilingual search, category filters and source/requirement guidance.
23
27
  - **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.
24
28
  - **Adjust presentation:** model and number formats, labels, built-in icons, colors, directory styles, and automatic or explicit rows with priorities and width limits.
25
29
  - **Keep Unicode intact:** joined emoji, combining marks and CJK text stay together when rows wrap, clip or appear in previews.
@@ -29,65 +33,65 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
29
33
  - **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.
30
34
  - **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.
31
35
 
32
- 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.2.0/docs/DISPLAY_ITEMS.md) for data sources and availability.
36
+ 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.4.0/docs/DISPLAY_ITEMS.md) for data sources and availability.
33
37
 
34
38
  <a id="界面预览"></a>
35
39
 
36
40
  ## Screenshots
37
41
 
38
- [Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/images/composition/README.md).
42
+ [Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/images/composition/README.md).
39
43
 
40
- [Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/images/README.md#discovery-and-import-review).
44
+ [Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/images/README.md#discovery-and-import-review).
41
45
 
42
46
 
43
- 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.2.0/docs/images/README.md).
47
+ 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.4.0/docs/images/README.md).
44
48
 
45
49
  <details>
46
50
  <summary>English / 简体中文 configuration</summary>
47
51
 
48
- 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.2.0/docs/images/README.md#bilingual-terminal-captures).
52
+ 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.4.0/docs/images/README.md#bilingual-terminal-captures).
49
53
 
50
- ![English native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/linux/languages/settings-en.png)
54
+ ![English native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/linux/languages/settings-en.png)
51
55
 
52
- ![简体中文 native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/linux/languages/settings-zh-CN.png)
56
+ ![简体中文 native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/linux/languages/settings-zh-CN.png)
53
57
 
54
- ![简体中文 external language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/typescript/external/linux/zh-CN/settings.png)
58
+ ![简体中文 external language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/typescript/external/linux/zh-CN/settings.png)
55
59
 
56
60
  </details>
57
61
 
58
62
  ### In-session TUI
59
63
 
60
- 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.2.0/docs/development/native.md#terminal-background-previews).
64
+ 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.4.0/docs/development/native.md#terminal-background-previews).
61
65
 
62
66
  **Linux: Main and the status line**
63
67
 
64
- ![Linux in-session TUI Main page and actual main status line](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/linux/main.png)
68
+ ![Linux in-session TUI Main page and actual main status line](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/linux/main.png)
65
69
 
66
70
  <details>
67
71
  <summary>Linux: Subagents, Settings, Layout</summary>
68
72
 
69
73
  **Subagents: choose items and ordering for individual agent rows.**
70
74
 
71
- ![Linux in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/linux/subagents.png)
75
+ ![Linux in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/linux/subagents.png)
72
76
 
73
77
  **Settings: adjust appearance, refresh behavior and formatting.**
74
78
 
75
- ![Linux in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/linux/settings.png)
79
+ ![Linux in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/linux/settings.png)
76
80
 
77
81
  **Layout: set rows, item priorities and maximum widths.**
78
82
 
79
- ![Linux in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/linux/layout.png)
83
+ ![Linux in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/linux/layout.png)
80
84
 
81
85
  </details>
82
86
 
83
87
  <details>
84
88
  <summary>Linux: light and dark themes</summary>
85
89
 
86
- 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.2.0/docs/images/README.md#theme-terminal-captures).
90
+ 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.4.0/docs/images/README.md#theme-terminal-captures).
87
91
 
88
- ![Linux light theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/linux/themes/main-light.png)
92
+ ![Linux light theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/linux/themes/main-light.png)
89
93
 
90
- ![Linux dark theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/linux/themes/main-dark.png)
94
+ ![Linux dark theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/linux/themes/main-dark.png)
91
95
 
92
96
  </details>
93
97
 
@@ -96,30 +100,30 @@ Earlier theme captures used a dark preview surface; the current editor offers a
96
100
 
97
101
  **Main: select and reorder main status line items.**
98
102
 
99
- ![Windows in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/windows/main.png)
103
+ ![Windows in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/windows/main.png)
100
104
 
101
105
  **Subagents: choose items and ordering for individual agent rows.**
102
106
 
103
- ![Windows in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/windows/subagents.png)
107
+ ![Windows in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/windows/subagents.png)
104
108
 
105
109
  **Settings: adjust appearance, refresh behavior and formatting.**
106
110
 
107
- ![Windows in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/windows/settings.png)
111
+ ![Windows in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/windows/settings.png)
108
112
 
109
113
  **Layout: set rows, item priorities and maximum widths.**
110
114
 
111
- ![Windows in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/windows/layout.png)
115
+ ![Windows in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/windows/layout.png)
112
116
 
113
117
  </details>
114
118
 
115
119
  <details>
116
120
  <summary>macOS: Main</summary>
117
121
 
118
- 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.2.0/docs/USER_GUIDE.md#macos-mouse-reporting-and-client-focus).
122
+ 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.4.0/docs/USER_GUIDE.md#macos-mouse-reporting-and-client-focus).
119
123
 
120
124
  **Main: select and reorder main status line items.**
121
125
 
122
- ![macOS in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/native/macos/main.png)
126
+ ![macOS in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/native/macos/main.png)
123
127
 
124
128
  </details>
125
129
 
@@ -130,19 +134,19 @@ Run `/statusline-configure` in Claude Code, or `claude-statusline configure` in
130
134
  <details>
131
135
  <summary>Linux: light/dark backgrounds and palette comparison</summary>
132
136
 
133
- 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.2.0/docs/images/README.md#external-terminal-color-captures).
137
+ 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.4.0/docs/images/README.md#external-terminal-color-captures).
134
138
 
135
139
  **Light background, Palette: default**
136
140
 
137
- ![Linux light terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/linux/themes/main-light.png)
141
+ ![Linux light terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/linux/themes/main-light.png)
138
142
 
139
143
  **Light background, Palette: ansi**
140
144
 
141
- ![Linux light terminal with ANSI palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/linux/themes/main-light-ansi.png)
145
+ ![Linux light terminal with ANSI palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/linux/themes/main-light-ansi.png)
142
146
 
143
147
  **Dark background, Palette: default**
144
148
 
145
- ![Linux dark terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/linux/themes/main-dark.png)
149
+ ![Linux dark terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/linux/themes/main-dark.png)
146
150
 
147
151
  </details>
148
152
 
@@ -151,19 +155,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
151
155
 
152
156
  **Main: select and reorder main status line items.**
153
157
 
154
- ![Linux external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/typescript/external/linux/en/main.png)
158
+ ![Linux external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/typescript/external/linux/en/main.png)
155
159
 
156
160
  **Subagents: choose items and ordering for individual agent rows.**
157
161
 
158
- ![Linux external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/typescript/external/linux/en/subagents.png)
162
+ ![Linux external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/typescript/external/linux/en/subagents.png)
159
163
 
160
164
  **Settings: adjust appearance, refresh behavior and formatting.**
161
165
 
162
- ![Linux external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/typescript/external/linux/en/settings.png)
166
+ ![Linux external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/typescript/external/linux/en/settings.png)
163
167
 
164
168
  **Layout: set rows, item priorities and maximum widths.**
165
169
 
166
- ![Linux external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/typescript/external/linux/en/layout.png)
170
+ ![Linux external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/typescript/external/linux/en/layout.png)
167
171
 
168
172
  </details>
169
173
 
@@ -172,19 +176,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
172
176
 
173
177
  **Main: select and reorder main status line items.**
174
178
 
175
- ![Windows external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/windows/main.png)
179
+ ![Windows external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/windows/main.png)
176
180
 
177
181
  **Subagents: choose items and ordering for individual agent rows.**
178
182
 
179
- ![Windows external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/windows/subagents.png)
183
+ ![Windows external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/windows/subagents.png)
180
184
 
181
185
  **Settings: adjust appearance, refresh behavior and formatting.**
182
186
 
183
- ![Windows external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/windows/settings.png)
187
+ ![Windows external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/windows/settings.png)
184
188
 
185
189
  **Layout: set rows, item priorities and maximum widths.**
186
190
 
187
- ![Windows external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/windows/layout.png)
191
+ ![Windows external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/windows/layout.png)
188
192
 
189
193
  </details>
190
194
 
@@ -193,23 +197,23 @@ Previews use the current terminal background and selected palette. Compare `ansi
193
197
 
194
198
  **Main: select and reorder main status line items.**
195
199
 
196
- ![macOS external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/macos/main.png)
200
+ ![macOS external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/macos/main.png)
197
201
 
198
202
  **Subagents: choose items and ordering for individual agent rows.**
199
203
 
200
- ![macOS external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/macos/subagents.png)
204
+ ![macOS external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/macos/subagents.png)
201
205
 
202
206
  **Settings: adjust appearance, refresh behavior and formatting.**
203
207
 
204
- ![macOS external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/macos/settings.png)
208
+ ![macOS external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/macos/settings.png)
205
209
 
206
210
  **Layout: set rows, item priorities and maximum widths.**
207
211
 
208
- ![macOS external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/tui/external/macos/layout.png)
212
+ ![macOS external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/tui/external/macos/layout.png)
209
213
 
210
214
  </details>
211
215
 
212
- Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/images/archive/README.md).
216
+ Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/images/archive/README.md).
213
217
 
214
218
  ## Supported platforms
215
219
 
@@ -221,7 +225,7 @@ Earlier screenshots and terminal reconstructions remain in the [archive](https:/
221
225
 
222
226
  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`.
223
227
 
224
- 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.2.0/docs/USER_GUIDE.md#requirements).
228
+ 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.4.0/docs/USER_GUIDE.md#requirements).
225
229
 
226
230
  <a id="install-current-source"></a>
227
231
  <a id="install-from-a-release-recommended"></a>
@@ -239,7 +243,7 @@ Claude Code feature requirements: subagent rows 2.1.205+; local argument-based c
239
243
 
240
244
  ## Quick installation
241
245
 
242
- 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.2.0/docs/USER_GUIDE.md#upgrading).
246
+ 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.4.0/docs/USER_GUIDE.md#upgrading).
243
247
 
244
248
  ### Install the package
245
249
 
@@ -262,28 +266,28 @@ claude-statusline doctor
262
266
 
263
267
  On Windows, use `claude-statusline.cmd`, or invoke the installed JavaScript entry with Node. Restart Claude Code in a trusted terminal after integration.
264
268
 
265
- 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; `install` does not open an editor. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
269
+ 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; `install` does not open an editor. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
266
270
 
267
271
  <details>
268
272
  <summary>Other installation methods</summary>
269
273
 
270
- Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.2.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.
274
+ Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.4.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.
271
275
 
272
- Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/development/README.md#build-and-install-from-source).
276
+ Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/development/README.md#build-and-install-from-source).
273
277
 
274
278
  </details>
275
279
 
276
280
  ## Common configuration
277
281
 
278
- 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.2.0/docs/USER_GUIDE.md#quick-setup-and-explanation).
282
+ 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.4.0/docs/USER_GUIDE.md#quick-setup-and-explanation).
279
283
 
280
- [Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#item-discovery-import-review).
284
+ [Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#item-discovery-import-review).
281
285
 
282
286
 
283
287
  | Entry point | Use |
284
288
  | --- | --- |
285
- | `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#native-configuration-editor) |
286
- | `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
289
+ | `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#native-configuration-editor) |
290
+ | `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
287
291
  | `claude-statusline configure` | Full TUI in the current standalone terminal |
288
292
  | `/statusline-config` | Claude question-and-answer wizard; supported argument-based commands execute locally on compatible hosts |
289
293
  | `claude-statusline config ...` | Inspect settings, set exact ordering, or configure from scripts |
@@ -301,7 +305,7 @@ claude-statusline config language reset
301
305
  claude-statusline --language en --help
302
306
  ```
303
307
 
304
- `--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.2.0/docs/USER_GUIDE.md#interface-language).
308
+ `--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.4.0/docs/USER_GUIDE.md#interface-language).
305
309
 
306
310
  ### Statusline language
307
311
 
@@ -312,13 +316,13 @@ claude-statusline config set statusline-language zh-TW
312
316
  claude-statusline config set statusline-language en
313
317
  ```
314
318
 
315
- ![English statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/statusline/linux/en.png)
319
+ ![English statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/statusline/linux/en.png)
316
320
 
317
- ![Simplified Chinese statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.2.0/docs/images/statusline/linux/zh-CN.png)
321
+ ![Simplified Chinese statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.4.0/docs/images/statusline/linux/zh-CN.png)
318
322
 
319
- These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/images/README.md#statusline-language-captures).
323
+ These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/images/README.md#statusline-language-captures).
320
324
 
321
- 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.2.0/docs/USER_GUIDE.md#statusline-language).
325
+ 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.4.0/docs/USER_GUIDE.md#statusline-language).
322
326
 
323
327
  ### Native configuration editor
324
328
 
@@ -338,7 +342,7 @@ claude-statusline config set directory-style home
338
342
  claude-statusline config show
339
343
  ```
340
344
 
341
- 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.2.0/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/reference/cli.md).
345
+ 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.4.0/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/reference/cli.md).
342
346
 
343
347
  <a id="upgrade-to-v161"></a>
344
348
 
@@ -352,7 +356,7 @@ claude-statusline install
352
356
  claude-statusline doctor
353
357
  ```
354
358
 
355
- Existing Python installations should first follow the [migration and rollback procedure](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#migrate-the-previous-distribution-name). Saved display settings, runtime state, and integration preferences remain. For older display schemas or package downgrade, follow [version compatibility](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#version-compatibility).
359
+ Existing Python installations should first follow the [migration and rollback procedure](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#migrate-the-previous-distribution-name). Saved display settings, runtime state, and integration preferences remain. For older display schemas or package downgrade, follow [version compatibility](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#version-compatibility).
356
360
 
357
361
  Remove Claude integration before uninstalling the package:
358
362
 
@@ -362,7 +366,7 @@ claude-statusline uninstall
362
366
  npm uninstall --global @fbincon/claude-code-statusline
363
367
  ```
364
368
 
365
- Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md#uninstalling).
369
+ Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md#uninstalling).
366
370
 
367
371
  ## Project structure
368
372
 
@@ -412,15 +416,15 @@ claude-code-statusline/
412
416
 
413
417
  ## Documentation and help
414
418
 
415
- - [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
416
- - [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/reference/cli.md): commands, options, fields, files, and exit codes.
417
- - [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
418
- - [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/docs/RELEASING.md).
419
- - [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
419
+ - [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
420
+ - [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/reference/cli.md): commands, options, fields, files, and exit codes.
421
+ - [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
422
+ - [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/docs/RELEASING.md).
423
+ - [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
420
424
  - [GitHub Issues](https://github.com/fbincon/claude-code-statusline/issues): include versions, reproduction steps, and diagnostic results; remove private paths and session content.
421
425
 
422
426
  ## License
423
427
 
424
- [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
428
+ [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
425
429
 
426
- Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.2.0/tools/unicode/WCWIDTH-LICENSE.txt).
430
+ Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.4.0/tools/unicode/WCWIDTH-LICENSE.txt).