@fbincon/claude-code-statusline 3.16.0 → 3.16.2

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 (92) hide show
  1. package/README.md +72 -320
  2. package/candidate.json +300 -235
  3. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.d.ts +14 -0
  4. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.js +41 -0
  5. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.js.map +1 -1
  6. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic.js +8 -6
  7. package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic.js.map +1 -1
  8. package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.d.ts +6 -1
  9. package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.js +94 -49
  10. package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.js.map +1 -1
  11. package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.d.ts +1 -1
  12. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/.claude-plugin/plugin.json +1 -1
  13. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/hooks/register.ts +160 -33
  14. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/keys.ts +22 -15
  15. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/change-review.ts +5 -0
  16. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/color-manager.ts +7 -4
  17. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/diagnosis-view.ts +52 -18
  18. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/draft.ts +22 -2
  19. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/setup.ts +1 -1
  20. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/source-manager.ts +6 -5
  21. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/task-viewer.ts +24 -0
  22. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/de.ts +17 -4
  23. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/en.ts +17 -4
  24. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/es.ts +17 -4
  25. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/fr.ts +17 -4
  26. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/id.ts +17 -4
  27. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/ja.ts +17 -4
  28. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/ko.ts +17 -4
  29. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/pt-BR.ts +17 -4
  30. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/ru.ts +17 -4
  31. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-CN.ts +17 -4
  32. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-HK.ts +17 -4
  33. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/locales/zh-TW.ts +17 -4
  34. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/resource-manifest.json +27 -26
  35. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/draw.ts +20 -6
  36. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/help.ts +11 -3
  37. package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/task-controls.ts +47 -0
  38. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/.claude-plugin/plugin.json +1 -1
  39. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/hooks/observe.ts +3 -2
  40. package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/resource-manifest.json +4 -4
  41. package/node_modules/@fbincon/statusline-core/dist/src/editor/change-review.d.ts +1 -0
  42. package/node_modules/@fbincon/statusline-core/dist/src/editor/change-review.js +5 -0
  43. package/node_modules/@fbincon/statusline-core/dist/src/editor/change-review.js.map +1 -1
  44. package/node_modules/@fbincon/statusline-core/dist/src/editor/color-manager.js +7 -4
  45. package/node_modules/@fbincon/statusline-core/dist/src/editor/color-manager.js.map +1 -1
  46. package/node_modules/@fbincon/statusline-core/dist/src/editor/diagnosis-view.d.ts +5 -2
  47. package/node_modules/@fbincon/statusline-core/dist/src/editor/diagnosis-view.js +64 -18
  48. package/node_modules/@fbincon/statusline-core/dist/src/editor/diagnosis-view.js.map +1 -1
  49. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.d.ts +4 -0
  50. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js +19 -2
  51. package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js.map +1 -1
  52. package/node_modules/@fbincon/statusline-core/dist/src/editor/setup.js +1 -1
  53. package/node_modules/@fbincon/statusline-core/dist/src/editor/setup.js.map +1 -1
  54. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.js +6 -5
  55. package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.js.map +1 -1
  56. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-viewer.d.ts +2 -0
  57. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-viewer.js +29 -0
  58. package/node_modules/@fbincon/statusline-core/dist/src/editor/task-viewer.js.map +1 -1
  59. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.d.ts +1 -1
  60. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js +204 -48
  61. package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js.map +1 -1
  62. package/node_modules/@fbincon/statusline-core/dist/src/release.d.ts +1 -1
  63. package/node_modules/@fbincon/statusline-core/dist/src/release.js +1 -1
  64. package/node_modules/@fbincon/statusline-core/dist/src/runtime/tasks/native.js +6 -0
  65. package/node_modules/@fbincon/statusline-core/dist/src/runtime/tasks/native.js.map +1 -1
  66. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/de.json +17 -4
  67. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/en.json +17 -4
  68. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/es.json +17 -4
  69. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/fr.json +17 -4
  70. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/id.json +17 -4
  71. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ja.json +17 -4
  72. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ko.json +17 -4
  73. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/pt-BR.json +17 -4
  74. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ru.json +17 -4
  75. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-CN.json +17 -4
  76. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-HK.json +17 -4
  77. package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-TW.json +17 -4
  78. package/node_modules/@fbincon/statusline-platform/dist/src/terminal/input.d.ts +11 -4
  79. package/node_modules/@fbincon/statusline-platform/dist/src/terminal/input.js +138 -60
  80. package/node_modules/@fbincon/statusline-platform/dist/src/terminal/input.js.map +1 -1
  81. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js +4 -5
  82. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js.map +1 -1
  83. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js +14 -4
  84. package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js.map +1 -1
  85. package/node_modules/@fbincon/statusline-tui/dist/src/drawing.js +17 -1
  86. package/node_modules/@fbincon/statusline-tui/dist/src/drawing.js.map +1 -1
  87. package/node_modules/@fbincon/statusline-tui/dist/src/session.js +4 -2
  88. package/node_modules/@fbincon/statusline-tui/dist/src/session.js.map +1 -1
  89. package/node_modules/@fbincon/statusline-tui/dist/src/state.d.ts +2 -0
  90. package/node_modules/@fbincon/statusline-tui/dist/src/state.js +45 -26
  91. package/node_modules/@fbincon/statusline-tui/dist/src/state.js.map +1 -1
  92. package/package.json +1 -1
package/README.md CHANGED
@@ -1,17 +1,13 @@
1
1
  # Claude Code Statusline
2
2
 
3
- **English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/README.zh-CN.md)
4
-
5
-
6
- Shared undo/redo, current-file comparison, reviewed alignment repairs and selected style/whole-group reuse are described in [draft history and reuse](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/DRAFT_HISTORY.md).
3
+ **English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/README.zh-CN.md)
7
4
 
8
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)
9
- [npm](https://www.npmjs.com/package/@fbincon/claude-code-statusline)
10
- [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/LICENSE)
6
+ [npm](https://www.npmjs.com/package/@fbincon/claude-code-statusline) · [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/LICENSE)
11
7
 
12
- A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reasoning effort, directory, Git, context, usage limits, tokens, and task timing at a glance. Configure the main line and individual subagent rows through an in-session editor, a terminal UI, a wizard, or the CLI.
8
+ A configurable Claude Code status line for Linux, WSL, Windows and macOS. See model and reasoning effort, project, Git, context, usage and task timing at a glance. Configure the main line and individual subagent rows in the current Claude session, a terminal editor or the CLI.
13
9
 
14
- [Features](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#troubleshooting)
10
+ [Demonstrations](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SHOWCASE.md) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#troubleshooting)
15
11
 
16
12
  <a id="phase-4-in-stable-v150"></a>
17
13
  <a id="phase-5-in-stable-v160"></a>
@@ -19,207 +15,40 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
19
15
 
20
16
  ## Features
21
17
 
22
- - **Add explicit data sources:** manage local JSON, GitHub checks and command values in either editor or CLI, with separately reviewed activation and automatic GitHub/command refresh during active sessions, plus optional directory/PR links. [Extension guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/EXTENSIONS.md).
23
- - **Reuse display schemes across projects:** save and preview named schemes, then bind project roots to complete display settings. [Profile guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/PROFILES.md).
24
- - **Inspect task evidence:** open `/statusline-task`, `task view` or the external editor to browse task evidence with search, filters and folding. [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/TASK_DETAILS.md).
25
-
26
- - **Compose your statusline:** add, copy and arrange independent components, linked groups, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/COMPOSITION.md).
27
- - **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors, themes and short percentage bars, and opt into [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/APPEARANCE.md).
28
- - **Choose your languages:** English / 简体中文 / 繁體中文(台灣) / 繁體中文(香港) / 日本語 / 한국어 / Español / Français / Deutsch / Português (Brasil) / Русский / Bahasa Indonesia 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.16.0/docs/images/typescript/v3.16.0/README.md).
29
- - **Review colors and samples:** press Enter on a color field for visible choices; Ctrl+V selects a sample scenario, Ctrl+W changes preview width and Ctrl+N browses rows. See [appearance](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/APPEARANCE.md#visual-color-selection-and-sample-scenarios).
30
- - **Diagnose supplied input:** press Ctrl+L in either editor to inspect a file with the unsaved draft and input-only evidence by default, or use the CLI. See [input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/DIAGNOSTICS.md).
31
- - **Find what to show:** 65 main metrics and 15 subagent metrics, plus text and flexible spacers, with ranked multilingual search, category filters and source/requirement guidance.
32
- - **Estimate session cost rates:** choose session or cumulative API time as the denominator, with a one-minute observation window and explicit units. [Metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/DISPLAY_ITEMS.md#session-cost-rate).
33
- - **Track the right scope:** session token totals, per-task subagent rows, and total task time covering queueing, agents and main-agent wrap-up; optional execution time excludes verified user waits.
34
- - **Adjust presentation:** model and number formats, labels, built-in icons, colors, directory styles, and automatic or explicit rows with priorities and width limits.
35
- - **Keep Unicode intact:** joined emoji, combining marks and CJK text stay together when rows wrap, clip or appear in previews.
36
- - **Review configuration changes:** three complete display schemes, six existing presets and portable JSON, with import differences and candidate previews before accepting a draft and saving.
37
- - **Choose an editor:** Main, Subagents, Settings, and Layout pages share the same configuration. Claude appearance and behavior preferences use a separate Apply action.
38
- - **Follow Claude themes:** the in-session editor adapts text, keys and selection to the applied theme; sample previews retain production colors on a separately chosen light/dark background.
39
- - **Follow terminal colors:** external TUI text and bold keys use terminal defaults, with cyan headings; previews show the selected palette on the current terminal background.
40
- - **Enable optional live metrics:** runtime state, agent count, tool progress, request timing, and per-task usage are opt-in. Missing or partial observations stay distinguishable.
41
-
42
- Rendering uses Claude Code input and local state without making network requests or using model tokens. The question-and-answer wizard uses Claude model turns. See [field definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/DISPLAY_ITEMS.md) for data sources and availability.
18
+ - **Choose what to see:** 65 main metrics and 15 subagent metrics, plus text and flexible spacers. Search names, IDs and descriptions across twelve languages. [Metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/DISPLAY_ITEMS.md).
19
+ - **Compose a readable display:** independent component copies, linked groups, explicit rows, left/right layout, conditional visibility, colors, gradients and adaptive percentage indicators. [Composition](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/COMPOSITION.md) · [Appearance](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/APPEARANCE.md).
20
+ - **Start from a scheme:** eight complete display schemes and six original presets remain editable. Save named schemes, bind projects and reuse selected styles or whole groups. [Schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SCHEMES.md) · [Project bindings](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/PROFILES.md).
21
+ - **Review before saving:** sample scenarios, width previews, import differences, shared undo/redo and current-file comparison help inspect a draft. [Draft history and reuse](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/DRAFT_HISTORY.md).
22
+ - **Follow tasks and agents:** separate session and per-agent metrics, task timing through agent work and main wrap-up, and a searchable task-evidence viewer. [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/TASK_DETAILS.md).
23
+ - **Add explicit data sources:** local JSON, GitHub checks and command values, with separately reviewed activation, refresh and optional links. [Extensions](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/EXTENSIONS.md).
24
+ - **Choose interface and output languages independently:** English, 简体中文, 繁體中文(台灣), 繁體中文(香港), 日本語, 한국어, Español, Français, Deutsch, Português (Brasil), Русский and Bahasa Indonesia.
25
+ - **Diagnose and recover:** inspect supplied input, review package changes and restore compatible configuration backups explicitly. [Input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/DIAGNOSTICS.md) · [Package management](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/PACKAGE_MANAGEMENT.md).
26
+
27
+ Rendering reads Claude Code input and local state without network requests or model tokens. Optional source refresh is separate; the question-and-answer wizard uses Claude model turns. Missing observations remain distinguishable from zero.
43
28
 
44
29
  <a id="界面预览"></a>
45
30
 
46
31
  ## Screenshots
47
32
 
48
- [Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/images/composition/README.md).
49
-
50
- [Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/images/README.md#discovery-and-import-review).
51
-
52
-
53
- The main status line at the bottom of session screenshots shows actual data; configuration Preview regions use fixed samples. Fonts, colors and widths depend on terminal settings. [Image sources and archive](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/images/README.md).
54
-
55
- <details>
56
- <summary>English / 简体中文 configuration</summary>
33
+ The [complete demonstrations](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SHOWCASE.md) pair scene configurations with reproducible steps for setup, editing, tasks, sources and version review. The visual baseline uses classic separators and soft, bright foreground gradients without Powerline. A component keeps its colors across main and subagent rows; the light scene uses darker shades of the same hues. Each asset's package, input and capture type is recorded in the [showcase image index](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/images/showcase/README.md); fixed samples are identified separately from recorded task observations.
57
34
 
58
- Linux terminal captures show the shared language selector and Chinese interface. These are reconstructions of actual PTY cells with sample previews; [sources and all pages](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/images/README.md#bilingual-terminal-captures).
35
+ ![Daily development statusline with classic separators and distinct foreground gradients](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.2/docs/images/showcase/en/daily.png)
59
36
 
60
- ![English native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/linux/languages/settings-en.png)
37
+ ![Configuration workflow with a colored statusline preview and reviewed changes](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.2/docs/images/showcase/en/configure.gif)
61
38
 
62
- ![简体中文 native language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/linux/languages/settings-zh-CN.png)
63
-
64
- ![简体中文 external language selector](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/typescript/external/linux/zh-CN/settings.png)
65
-
66
- </details>
39
+ The clip copies one metric, then demonstrates Undo, Redo, Save and reopening. The duplicate belongs only to this exercise; the original daily scene is restored afterward.
67
40
 
68
41
  ### In-session TUI
69
42
 
70
- Run `/statusline-configure-native` inside the current Claude Code session, then click the Client region once before using the keyboard. The editor follows the Claude theme; choose the preview background to match the terminal and compare the selected palette. [Compare terminal/theme combinations](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/development/native.md#terminal-background-previews).
71
-
72
- **Linux: Main and the status line**
73
-
74
- ![Linux in-session TUI Main page and actual main status line](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/linux/main.png)
75
-
76
- <details>
77
- <summary>Linux: Subagents, Settings, Layout</summary>
78
-
79
- **Subagents: choose items and ordering for individual agent rows.**
80
-
81
- ![Linux in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/linux/subagents.png)
82
-
83
- **Settings: adjust appearance, refresh behavior and formatting.**
84
-
85
- ![Linux in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/linux/settings.png)
86
-
87
- **Layout: set rows, item priorities and maximum widths.**
88
-
89
- ![Linux in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/linux/layout.png)
90
-
91
- </details>
92
-
93
- <details>
94
- <summary>Linux: light and dark themes</summary>
95
-
96
- Earlier theme captures used a dark preview surface; the current editor offers a separate light/dark preview choice. These images reconstruct real terminal cells. [Capture provenance](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/images/README.md#theme-terminal-captures).
97
-
98
- ![Linux light theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/linux/themes/main-light.png)
99
-
100
- ![Linux dark theme native editor](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/linux/themes/main-dark.png)
101
-
102
- </details>
103
-
104
- <details>
105
- <summary>Windows: Main, Subagents, Settings, Layout</summary>
106
-
107
- **Main: select and reorder main status line items.**
108
-
109
- ![Windows in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/windows/main.png)
110
-
111
- **Subagents: choose items and ordering for individual agent rows.**
112
-
113
- ![Windows in-session TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/windows/subagents.png)
114
-
115
- **Settings: adjust appearance, refresh behavior and formatting.**
116
-
117
- ![Windows in-session TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/windows/settings.png)
118
-
119
- **Layout: set rows, item priorities and maximum widths.**
120
-
121
- ![Windows in-session TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/windows/layout.png)
122
-
123
- </details>
124
-
125
- <details>
126
- <summary>macOS: Main</summary>
127
-
128
- Only Main was supplied for this batch. The existing interaction limitation and checks are documented in [macOS mouse reporting and Client focus](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#macos-mouse-reporting-and-client-focus).
129
-
130
- **Main: select and reorder main status line items.**
131
-
132
- ![macOS in-session TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/native/macos/main.png)
133
-
134
- </details>
43
+ Run `/statusline-configure-native` inside Claude Code and click the Client region once before using the keyboard. [Editor workflow](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#native-configuration-editor).
135
44
 
136
45
  ### External TUI
137
46
 
138
- Run `/statusline-configure` in Claude Code, or `claude-statusline configure` in a standalone terminal.
139
-
140
- <details>
141
- <summary>Linux: light/dark backgrounds and palette comparison</summary>
142
-
143
- Previews use the current terminal background and selected palette. Compare `ansi` in Settings when `default` looks faint. These are terminal-output reconstructions from dedicated GNOME profiles; [capture sources](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/images/README.md#external-terminal-color-captures).
144
-
145
- **Light background, Palette: default**
146
-
147
- ![Linux light terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/linux/themes/main-light.png)
148
-
149
- **Light background, Palette: ansi**
150
-
151
- ![Linux light terminal with ANSI palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/linux/themes/main-light-ansi.png)
152
-
153
- **Dark background, Palette: default**
154
-
155
- ![Linux dark terminal with default palette](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/linux/themes/main-dark.png)
156
-
157
- </details>
158
-
159
- <details>
160
- <summary>Linux: Main, Subagents, Settings, Layout</summary>
161
-
162
- **Main: select and reorder main status line items.**
163
-
164
- ![Linux external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/typescript/external/linux/en/main.png)
165
-
166
- **Subagents: choose items and ordering for individual agent rows.**
167
-
168
- ![Linux external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/typescript/external/linux/en/subagents.png)
169
-
170
- **Settings: adjust appearance, refresh behavior and formatting.**
47
+ Run `claude-statusline configure` in a terminal, or `/statusline-configure` from Claude Code to open a supported external terminal. [Terminal workflow](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#standalone-interactive-tui).
171
48
 
172
- ![Linux external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/typescript/external/linux/en/settings.png)
49
+ [All current and historical images](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/images/README.md) retain their original provenance. Historical cross-platform screenshots do not establish acceptance of a newer package; the six existing [issue #96 gaps](https://github.com/fbincon/claude-code-statusline/issues/96) remain unverified.
173
50
 
174
- **Layout: set rows, item priorities and maximum widths.**
175
-
176
- ![Linux external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/typescript/external/linux/en/layout.png)
177
-
178
- </details>
179
-
180
- <details>
181
- <summary>Windows: Main, Subagents, Settings, Layout</summary>
182
-
183
- **Main: select and reorder main status line items.**
184
-
185
- ![Windows external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/windows/main.png)
186
-
187
- **Subagents: choose items and ordering for individual agent rows.**
188
-
189
- ![Windows external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/windows/subagents.png)
190
-
191
- **Settings: adjust appearance, refresh behavior and formatting.**
192
-
193
- ![Windows external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/windows/settings.png)
194
-
195
- **Layout: set rows, item priorities and maximum widths.**
196
-
197
- ![Windows external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/windows/layout.png)
198
-
199
- </details>
200
-
201
- <details>
202
- <summary>macOS: Main, Subagents, Settings, Layout</summary>
203
-
204
- **Main: select and reorder main status line items.**
205
-
206
- ![macOS external TUI Main page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/macos/main.png)
207
-
208
- **Subagents: choose items and ordering for individual agent rows.**
209
-
210
- ![macOS external TUI Subagents page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/macos/subagents.png)
211
-
212
- **Settings: adjust appearance, refresh behavior and formatting.**
213
-
214
- ![macOS external TUI Settings page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/macos/settings.png)
215
-
216
- **Layout: set rows, item priorities and maximum widths.**
217
-
218
- ![macOS external TUI Layout page with sample preview](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/tui/external/macos/layout.png)
219
-
220
- </details>
221
-
222
- Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/images/archive/README.md).
51
+ <a id="支持范围"></a>
223
52
 
224
53
  ## Supported platforms
225
54
 
@@ -229,9 +58,7 @@ Earlier screenshots and terminal reconstructions remain in the [archive](https:/
229
58
  | Windows 10/11 | Node 22.x or 24.x, x64 |
230
59
  | macOS 14+ | Node 22.x or 24.x, Intel / Apple Silicon |
231
60
 
232
- Windows ARM devices use x64 Node under emulation; native Windows ARM64 and 32-bit runtimes are outside the current support contract. Git information requires `git`.
233
-
234
- Claude Code feature requirements: subagent rows 2.1.205+; local argument-based configuration and external TUI entry 2.1.258+; in-session Client 2.1.287+; native timing and advanced live-metrics collection 2.1.289+. Unsupported or unknown host versions suspend the corresponding integration. See [requirements](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#requirements).
61
+ Windows ARM devices use x64 Node under emulation; native Windows ARM64 and 32-bit runtimes are outside the support contract. Git fields require Git. Claude Code requirements vary by feature: subagent rows 2.1.205+, local slash arguments/external entry 2.1.258+, in-session editor 2.1.287+, native timing/live metrics 2.1.289+. [Requirements and limitations](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#requirements).
235
62
 
236
63
  <a id="install-current-source"></a>
237
64
  <a id="install-from-a-release-recommended"></a>
@@ -239,23 +66,16 @@ Claude Code feature requirements: subagent rows 2.1.205+; local argument-based c
239
66
  <a id="从-release-安装推荐"></a>
240
67
  <a id="从固定标签源码安装"></a>
241
68
  <a id="从当前源码安装"></a>
242
- <a id="升级与卸载"></a>
243
- <a id="常用配置"></a>
244
69
  <a id="快速安装"></a>
245
70
  <a id="接入-claude-code"></a>
246
- <a id="支持范围"></a>
247
- <a id="文档与帮助"></a>
248
- <a id="许可证"></a>
249
71
 
250
72
  ## Quick installation
251
73
 
252
- Install Node 22.x or 24.x with npm and Claude Code CLI. One npm package includes the supported native dependencies and needs no Python or compiler. [Existing Python installation and rollback](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#upgrading).
74
+ Install Node 22.x or 24.x with npm and Claude Code CLI. The package bundles its supported native dependencies and needs no Python or compiler.
253
75
 
254
76
  ### Install the package
255
77
 
256
- For a reviewed installation in an interactive terminal, run `npx @fbincon/claude-code-statusline`. It verifies the durable global entry before opening setup. An installed `claude-statusline` without a subcommand opens the same flow. [Installation stages](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/SETUP.md).
257
-
258
- Bash, Zsh, and PowerShell:
78
+ In an interactive terminal, `npx @fbincon/claude-code-statusline` reviews a persistent installation before opening setup. Alternatively, install the package explicitly:
259
79
 
260
80
  ```text
261
81
  npm install --global --ignore-scripts @fbincon/claude-code-statusline
@@ -272,93 +92,71 @@ claude-statusline setup
272
92
  claude-statusline doctor
273
93
  ```
274
94
 
275
- On Windows, use `claude-statusline.cmd`, or invoke the installed JavaScript entry with Node. Restart Claude Code in a trusted terminal after integration.
276
-
277
- Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing and advanced live metrics both require explicit opt-in on compatible hosts; saved choices are preserved. Package installation and Claude integration are separate steps. `setup` connects checks, scheme preview and integration review; `install` remains the direct integration command. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
278
-
279
- <details>
280
- <summary>Other installation methods</summary>
281
-
282
- Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.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.
95
+ On Windows, use `claude-statusline.cmd`, or invoke the installed JavaScript entry with Node. Restart Claude Code in a trusted terminal after integration. Package installation, display Save and Claude integration are separate stages; setup reports partial completion if a later stage fails.
283
96
 
284
- Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/development/README.md#build-and-install-from-source).
97
+ Both editors default on for compatible hosts and preserve saved choices. Native timing and advanced live metrics require explicit opt-in. See [first-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SETUP.md), [offline/fixed-version installation](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#installation-and-integration), [conflict handling](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name) and [Python migration](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#migrate-from-python).
285
98
 
286
- </details>
99
+ <a id="常用配置"></a>
287
100
 
288
101
  ## Common configuration
289
102
 
290
- In either editor, use **Ctrl+P** or **Settings → Quick setup** to choose a use case, appearance and sample before editing or saving. Text fields support grapheme cursor editing. Item details explain configuration, requirements and sample fitting. See [quick setup and explanation](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#quick-setup-and-explanation).
291
-
292
- [Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#item-discovery-import-review).
293
-
294
-
295
103
  | Entry point | Use |
296
104
  | --- | --- |
297
- | `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#native-configuration-editor) |
298
- | `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
299
- | `claude-statusline configure` | Full TUI in the current standalone terminal |
300
- | `/statusline-config` | Claude question-and-answer wizard; supported argument-based commands execute locally on compatible hosts |
301
- | `claude-statusline config ...` | Inspect settings, set exact ordering, or configure from scripts |
105
+ | `/statusline-configure-native` | Edit in the current Claude session |
106
+ | `/statusline-configure` | Launch an editor in a supported external terminal |
107
+ | `claude-statusline configure` | Edit in the current terminal, including SSH |
108
+ | `/statusline-config` | Claude question-and-answer wizard; supported argument commands run locally |
109
+ | `claude-statusline config ...` | Inspect settings or set exact values from scripts |
110
+
111
+ In either editor, **Ctrl+P** opens Quick setup to select a scheme, inspect requirements and preview the draft. Save applies it to the displayed user/profile/project target; cancel discards pending display changes. [Walkthroughs and reusable scenes](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SHOWCASE.md) · [All schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SCHEMES.md).
302
112
 
303
113
  <a id="v130a2-external-tui-and-in-session-client"></a>
304
114
 
305
115
  ### Interface language
306
116
 
307
- Both editors have **Interface language (saved immediately)** in Settings, with choices **English / 简体中文 / 繁體中文(台灣) / 繁體中文(香港) / 日本語 / 한국어 / Español / Français / Deutsch / Português (Brasil) / Русский / Bahasa Indonesia**. The default is English. Switching keeps your page, selection, search and unsaved display edits; cancelling display changes keeps the language choice. Other open windows read it when reopened or reloaded.
117
+ Set the shared interface preference, or override it for one invocation:
308
118
 
309
119
  ```text
310
- claude-statusline config language set ja
311
- claude-statusline config language show
312
- claude-statusline config language reset
313
- claude-statusline --language en --help
120
+ claude-statusline config language set zh-CN
121
+ claude-statusline --language en configure
314
122
  ```
315
123
 
316
- `--language en|zh-CN|zh-TW|zh-HK|ja|ko|es|fr|de|pt-BR|ru|id` 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.16.0/docs/USER_GUIDE.md#interface-language).
124
+ An interface-language change saves immediately and survives cancellation of display edits. [Language choices](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#interface-language).
317
125
 
318
126
  ### Statusline language
319
127
 
320
- Choose **Statusline language (save with display settings)** → **English / 简体中文 / 繁體中文(台灣) / 繁體中文(香港) / 日本語 / 한국어 / Español / Français / Deutsch / Português (Brasil) / Русский / Bahasa Indonesia** in either editor. Preview switches immediately; Save changes the actual main and subagent output on the next refresh, while Cancel discards the draft. English is the default.
321
-
322
- For example, save Spanish for the interface and Brazilian Portuguese for statusline output independently:
128
+ Set output language independently:
323
129
 
324
130
  ```text
325
- claude-statusline config language set es
326
- claude-statusline config set statusline-language pt-BR
131
+ claude-statusline config set statusline-language zh-CN
327
132
  ```
328
133
 
329
- ![English statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/statusline/linux/en.png)
330
-
331
- ![Simplified Chinese statusline output](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.0/docs/images/statusline/linux/zh-CN.png)
332
-
333
- These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/images/README.md#statusline-language-captures).
334
-
335
- 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.16.0/docs/USER_GUIDE.md#statusline-language).
134
+ In an editor, this choice changes the preview and takes effect in the actual main/subagent output only after display Save. Technical IDs, paths and custom text retain their values. [Output language](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#statusline-language).
336
135
 
337
136
  ### Native configuration editor
338
137
 
339
- Click the Client region once. Use Tab to change pages, Space to toggle, arrows to select or reorder, Ctrl+E for item formatting and source guidance, `/` to search, and Ctrl+F for categories. Clear filters before reordering. `S` saves and stays, `F` saves and closes, and `Q` discards unsaved changes; lowercase letters work too. Footer controls follow the current page or input mode. Ctrl+G cancels input. Claude preferences apply separately.
138
+ Click the Client region once. Tab changes pages, Space toggles, Ctrl+E opens item details, `/` searches and Ctrl+F filters categories. `S` saves and stays, `F` saves and closes, and `Q` discards the draft. Ctrl+G cancels field input. [Controls and recovery](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#native-configuration-editor).
340
139
 
341
140
  ### External and standalone terminal TUI
342
141
 
343
- Use Tab to change pages, Space to toggle, and arrows to select or reorder. Ctrl+S saves after field input is finished; Enter saves on item and original settings rows, or edits/confirms advanced fields. Esc cancels input first, then cancels the editor; Ctrl+C interrupts without saving. The minimum terminal size is 64×18.
142
+ Tab changes pages, Space toggles, and Ctrl+S saves after field input is finished. Esc cancels a field first, then the editor; Ctrl+C interrupts without saving. The minimum size is 64×18. [Controls and terminal launchers](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#standalone-interactive-tui).
344
143
 
345
- The external entry uses tmux or GNOME Terminal on Linux, tmux or Terminal.app on macOS, and the system's new-console launcher on Windows. For SSH or unavailable launchers, run `claude-statusline configure` in the current terminal.
346
-
347
- Define a compact main line:
144
+ To start from a built-in scheme with classic separators:
348
145
 
349
146
  ```text
350
- claude-statusline config set-items model-with-effort current-dir git context-remaining task-timer
351
- claude-statusline config set directory-style home
352
- claude-statusline config show
147
+ claude-statusline config preset daily-development --dry-run
148
+ claude-statusline config preset daily-development
149
+ claude-statusline config set separator-style classic
353
150
  ```
354
151
 
355
- 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.16.0/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/reference/cli.md).
152
+ Review before applying: a preset replaces display selections and layout. [Recipes](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#configuration-recipes) · [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/reference/cli.md).
356
153
 
154
+ <a id="升级与卸载"></a>
357
155
  <a id="upgrade-to-v161"></a>
358
156
 
359
157
  ## Upgrading and uninstalling
360
158
 
361
- Review and apply the package change, then restart Claude Code:
159
+ Review and apply a package change, then restart Claude Code:
362
160
 
363
161
  ```text
364
162
  claude-statusline update --check
@@ -366,9 +164,7 @@ claude-statusline update
366
164
  claude-statusline doctor
367
165
  ```
368
166
 
369
- Use [package management](https://github.com/fbincon/claude-code-statusline/blob/v3.16.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.16.0/docs/USER_GUIDE.md#migrate-the-previous-distribution-name). Saved display settings, runtime state, and integration preferences remain.
370
-
371
- Remove Claude integration before uninstalling the package:
167
+ [Package management](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/PACKAGE_MANAGEMENT.md) explains exact versions, prefixes, rollback and separate configuration restoration. Remove Claude integration before uninstalling the package:
372
168
 
373
169
  ```text
374
170
  claude-statusline uninstall --dry-run
@@ -376,80 +172,36 @@ claude-statusline uninstall
376
172
  npm uninstall --global @fbincon/claude-code-statusline
377
173
  ```
378
174
 
379
- Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md#uninstalling).
175
+ Display settings and backups remain. [Uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#uninstalling).
380
176
 
381
177
  ## Project structure
382
178
 
383
- ```text
384
- claude-code-statusline/
385
- ├── .github/
386
- │ ├── ISSUE_TEMPLATE/ # Bilingual bug form and feedback links
387
- │ ├── pull_request_template.md # Bilingual PR template
388
- │ ├── dependabot.yml # Actions version-update policy
389
- │ └── workflows/
390
- │ ├── ci.yml # Documentation checks or complete product matrix
391
- │ ├── npm-publish.yml # npm publication through OIDC
392
- │ ├── preview-downloads.yml # Public bytes and installation checks
393
- │ └── reference.yml # Manual historical Python verification
394
- ├── packages/ # Four business packages
395
- │ ├── core/src/ # Configuration, protocols, pure state, rendering and Unicode
396
- │ │ ├── editor/ # Shared drafts, cursor input, quick setup and explanations
397
- │ │ ├── rendering/ # Rendering, fitting and optional explanation records
398
- │ │ ├── contracts/ # Independently versioned editor/runtime interfaces
399
- │ │ └── i18n/ # Registry-generated languages; sources in core/resources
400
- │ ├── platform/src/ # Files, locks, processes, clocks and terminal adapters
401
- │ ├── cli/ # Commands, integration, runtime and recovery
402
- │ │ ├── src/ # Installation and editor protocols
403
- │ │ └── resources/ # Two configuration skill templates
404
- │ └── tui/src/ # Standalone terminal editor
405
- ├── mods/
406
- │ ├── statusline-native/ # In-session editor: hooks, lib, ui, tests
407
- │ └── statusline-runtime/ # Timing and optional live metrics
408
- ├── tests/fixtures/ # Shared contracts, Unicode and frozen reference data
409
- ├── tools/
410
- │ ├── generation/ # Shared resource generation
411
- │ ├── checks/ # Documentation, archive and aggregate checks
412
- │ ├── build/ # Fixed sources, universal offline packaging and digests
413
- │ ├── acceptance/ # Installation, Mods, terminals, power and budgeted acceptance
414
- │ ├── benchmarks/ # Functional fixtures and optional descriptive measurement
415
- │ ├── release/ # Candidate evidence and release-note preparation
416
- │ ├── migration/ # Stage ledgers, frozen references and compatibility tests
417
- │ ├── testing/ # Development-only test support package
418
- │ ├── typescript/ # Runtime constraints and test entry points
419
- │ └── unicode/ # Pinned data, provenance and licenses
420
- ├── archive/python/ # Frozen Python implementation, tests, tools and publishing workflows
421
- ├── examples/schemes/ # Shareable built-in complete schemes
422
- ├── docs/ # Usage, development, migration and historical releases
423
- │ ├── reference/ # CLI and configuration reference
424
- │ ├── development/ # Architecture, testing and stage records
425
- │ ├── images/ # UI screenshots and historical captures
426
- │ └── releases/ # Historical release notes
427
- ├── package.json / package-lock.json
428
- ├── tsconfig*.json / .node-version
429
- ├── README.md / README.zh-CN.md
430
- ├── CONTRIBUTING.md / CONTRIBUTING.zh-CN.md
431
- ├── SECURITY.md / SECURITY.zh-CN.md
432
- ├── CHANGELOG.md / CHANGELOG.zh-CN.md
433
- └── LICENSE
434
- ```
179
+ The TypeScript workspace separates pure rules (`packages/core`), platform effects (`packages/platform`), application services (`packages/cli`) and the terminal editor (`packages/tui`). `mods` contains the official-host integrations; `tools` contains generation, packaging and acceptance tooling. `archive/python` preserves the frozen historical implementation. [Architecture](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/development/architecture.md) · [Development setup](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/development/README.md).
180
+
181
+ <a id="文档与帮助"></a>
435
182
 
436
183
  ## Documentation and help
437
184
 
438
- - [First-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/SETUP.md) · [Three complete schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/SCHEMES.md) · [Appearance controls](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/APPEARANCE.md).
439
- - [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
440
- - [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/reference/cli.md): commands, options, fields, files, and exit codes.
441
- - [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
442
- - [Development roadmap](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/development/roadmap.md) · [Work-package plan](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/development/development-plan.md).
443
- - [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/docs/RELEASING.md).
444
- - [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
445
- - [GitHub Issues](https://github.com/fbincon/claude-code-statusline/issues): include versions, reproduction steps, and diagnostic results; remove private paths and session content.
185
+ | Goal | Start here |
186
+ | --- | --- |
187
+ | Try a complete workflow | [Demonstrations](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SHOWCASE.md) · [First-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SETUP.md) |
188
+ | Configure a display | [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md) · [Schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/SCHEMES.md) · [Appearance](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/APPEARANCE.md) · [Composition](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/COMPOSITION.md) |
189
+ | Reuse settings | [Profiles and projects](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/PROFILES.md) · [Draft history and reuse](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/DRAFT_HISTORY.md) |
190
+ | Understand data | [Metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/DISPLAY_ITEMS.md) · [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/TASK_DETAILS.md) · [Extensions](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/EXTENSIONS.md) |
191
+ | Diagnose or automate | [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/USER_GUIDE.md#troubleshooting) · [Input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/DIAGNOSTICS.md) · [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/reference/cli.md) |
192
+ | Develop or review evidence | [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/development/README.md) · [Image provenance](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/images/README.md) |
193
+ | Follow plans or releases | [Roadmap](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/development/roadmap.md) · [Development plan](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/docs/development/development-plan.md) · [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/CHANGELOG.md) |
194
+
195
+ [GitHub Issues](https://github.com/fbincon/claude-code-statusline/issues) accepts reproducible bugs, questions and feature ideas. Include versions, steps and relevant diagnostics; remove private paths and session content.
446
196
 
447
197
  ## Contributing and security
448
198
 
449
- See the [contribution guide](https://github.com/fbincon/claude-code-statusline/blob/v3.16.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.16.0/SECURITY.md).
199
+ See [Contributing](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/CONTRIBUTING.md) for development, translations and feedback. Report vulnerabilities privately through the [security policy](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/SECURITY.md).
200
+
201
+ <a id="许可证"></a>
450
202
 
451
203
  ## License
452
204
 
453
- [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
205
+ [MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
454
206
 
455
- Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.16.0/tools/unicode/WCWIDTH-LICENSE.txt).
207
+ Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.16.2/tools/unicode/WCWIDTH-LICENSE.txt).