@fbincon/claude-code-statusline 3.9.1 → 3.9.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.
- package/README.md +78 -78
- package/candidate.json +274 -230
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.js +17 -7
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/management/service.js +7 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/management/service.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.d.ts +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.js +3 -2
- package/node_modules/@fbincon/statusline-cli/dist/src/sources/automatic-state.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/sources/command.js +14 -5
- package/node_modules/@fbincon/statusline-cli/dist/src/sources/command.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.d.ts +3 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.js +56 -22
- package/node_modules/@fbincon/statusline-cli/dist/src/sources/service.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.d.ts +3 -3
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js +4 -2
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/.claude-plugin/plugin.json +1 -1
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/hooks/register.ts +76 -68
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/backend.ts +3 -3
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/keys.ts +1 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/settings.ts +1 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/alignment-manager.ts +2 -1
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/draft.ts +45 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/forms.ts +1 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/group-manager.ts +1 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/profile-manager.ts +14 -5
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/quick-setup.ts +1 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/source-manager.ts +15 -4
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/source-validation.ts +2 -2
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/generated-contracts.ts +6 -3
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/generated-locales.ts +66 -6
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/resource-manifest.json +18 -18
- package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/.claude-plugin/plugin.json +1 -1
- package/node_modules/@fbincon/statusline-cli/resources/statusline-runtime/resource-manifest.json +3 -3
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.d.ts +9 -3
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js +2 -1
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/alignment-manager.js +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/alignment-manager.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/backend.js +3 -3
- package/node_modules/@fbincon/statusline-core/dist/src/editor/backend.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.d.ts +16 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js +56 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/forms.js +4 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/forms.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/group-manager.js +5 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/group-manager.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/profile-manager.js +32 -3
- package/node_modules/@fbincon/statusline-core/dist/src/editor/profile-manager.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.js +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.d.ts +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.js +24 -4
- package/node_modules/@fbincon/statusline-core/dist/src/editor/source-manager.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/source-validation.js +2 -2
- package/node_modules/@fbincon/statusline-core/dist/src/editor/source-validation.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/extensions/model.d.ts +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/extensions/model.js +15 -1
- package/node_modules/@fbincon/statusline-core/dist/src/extensions/model.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.d.ts +60 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js +66 -6
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/en.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/en.js +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/en.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ja.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ja.js +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ja.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ko.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ko.js +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ko.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-CN.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-CN.js +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-CN.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-HK.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-HK.js +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-HK.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-TW.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-TW.js +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-TW.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/management/compatibility.js +2 -1
- package/node_modules/@fbincon/statusline-core/dist/src/management/compatibility.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/release.d.ts +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/release.js +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/indicators.js +5 -4
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/indicators.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/preferences.d.ts +4 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/preferences.js +6 -2
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/preferences.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/en.json +11 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ja.json +11 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ko.json +11 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-CN.json +11 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-HK.json +11 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-TW.json +11 -1
- package/node_modules/@fbincon/statusline-platform/dist/src/darwin-process.d.ts +8 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/darwin-process.js +33 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/darwin-process.js.map +1 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/npm.js +47 -16
- package/node_modules/@fbincon/statusline-platform/dist/src/npm.js.map +1 -1
- package/node_modules/@fbincon/statusline-platform/dist/src/package-copy.js +10 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/package-copy.js.map +1 -1
- package/node_modules/@fbincon/statusline-platform/dist/src/performance.d.ts +2 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/performance.js +17 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/performance.js.map +1 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/processes.js +7 -3
- package/node_modules/@fbincon/statusline-platform/dist/src/processes.js.map +1 -1
- package/node_modules/@fbincon/statusline-platform/dist/src/source-process.js +6 -12
- package/node_modules/@fbincon/statusline-platform/dist/src/source-process.js.map +1 -1
- package/node_modules/@fbincon/statusline-platform/dist/src/terminal/launchers.d.ts +1 -1
- package/node_modules/@fbincon/statusline-platform/dist/src/terminal/launchers.js +2 -5
- package/node_modules/@fbincon/statusline-platform/dist/src/terminal/launchers.js.map +1 -1
- package/node_modules/@fbincon/statusline-platform/dist/src/windows-command.d.ts +2 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/windows-command.js +7 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/windows-command.js.map +1 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/windows-source-exec.d.ts +1 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/windows-source-exec.js +65 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/windows-source-exec.js.map +1 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js +4 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/session.d.ts +1 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/session.js +33 -6
- package/node_modules/@fbincon/statusline-tui/dist/src/session.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/state.d.ts +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/state.js +12 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/state.js.map +1 -1
- package/package.json +2 -2
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.9.
|
|
3
|
+
**English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/README.zh-CN.md)
|
|
4
4
|
|
|
5
5
|
[](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.9.
|
|
7
|
+
[MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/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.9.
|
|
11
|
+
[Features](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#troubleshooting)
|
|
12
12
|
|
|
13
13
|
<a id="phase-4-in-stable-v150"></a>
|
|
14
14
|
<a id="phase-5-in-stable-v160"></a>
|
|
@@ -16,16 +16,16 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
|
|
|
16
16
|
|
|
17
17
|
## Features
|
|
18
18
|
|
|
19
|
-
- **Add explicit data sources:** manage local JSON, GitHub checks and command values in either editor or CLI, with reviewed activation, optional session-owned GitHub refresh and directory/PR links. [Extension guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
20
|
-
- **Reuse display schemes across projects:** save and preview named schemes, then bind project roots to complete display settings. [Profile guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
21
|
-
- **Inspect task evidence:** open `/statusline-task` or the CLI for task, agent, timing-source and coverage details on demand. [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
19
|
+
- **Add explicit data sources:** manage local JSON, GitHub checks and command values in either editor or CLI, with reviewed activation, optional session-owned GitHub refresh and directory/PR links. [Extension guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/EXTENSIONS.md).
|
|
20
|
+
- **Reuse display schemes across projects:** save and preview named schemes, then bind project roots to complete display settings. [Profile guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/PROFILES.md).
|
|
21
|
+
- **Inspect task evidence:** open `/statusline-task` or the CLI for task, agent, timing-source and coverage details on demand. [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/TASK_DETAILS.md).
|
|
22
22
|
|
|
23
|
-
- **Compose your statusline:** add, copy and arrange independent components, linked groups, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
24
|
-
- **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors, themes and short percentage bars, and opt into [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
25
|
-
- **Choose your languages:** English, 简体中文, 繁體中文, 日本語 and 한국어 for interfaces and actual statusline output, independently; interface changes save immediately, output language saves with display settings. See [language examples](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
26
|
-
- **Diagnose supplied input:** inspect real statusline JSON and matching saved observations without collecting or writing. See [input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
23
|
+
- **Compose your statusline:** add, copy and arrange independent components, linked groups, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/COMPOSITION.md).
|
|
24
|
+
- **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors, themes and short percentage bars, and opt into [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/APPEARANCE.md).
|
|
25
|
+
- **Choose your languages:** English, 简体中文, 繁體中文, 日本語 and 한국어 for interfaces and actual statusline output, independently; interface changes save immediately, output language saves with display settings. See [language examples](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/languages/README.md).
|
|
26
|
+
- **Diagnose supplied input:** inspect real statusline JSON and matching saved observations without collecting or writing. See [input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/DIAGNOSTICS.md).
|
|
27
27
|
- **Find what to show:** 65 main metrics and 15 subagent metrics, plus text and flexible spacers, with ranked multilingual search, category filters and source/requirement guidance.
|
|
28
|
-
- **Estimate session cost rates:** choose session or cumulative API time as the denominator, with a one-minute observation window and explicit units. [Metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
28
|
+
- **Estimate session cost rates:** choose session or cumulative API time as the denominator, with a one-minute observation window and explicit units. [Metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/DISPLAY_ITEMS.md#session-cost-rate).
|
|
29
29
|
- **Track the right scope:** session token totals, per-task subagent rows, and total task time covering queueing, agents and main-agent wrap-up; optional execution time excludes verified user waits.
|
|
30
30
|
- **Adjust presentation:** model and number formats, labels, built-in icons, colors, directory styles, and automatic or explicit rows with priorities and width limits.
|
|
31
31
|
- **Keep Unicode intact:** joined emoji, combining marks and CJK text stay together when rows wrap, clip or appear in previews.
|
|
@@ -35,65 +35,65 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
|
|
|
35
35
|
- **Follow terminal colors:** external TUI text and bold keys use terminal defaults, with cyan headings; previews show the selected palette on the current terminal background.
|
|
36
36
|
- **Enable optional live metrics:** runtime state, agent count, tool progress, request timing, and per-task usage are opt-in. Missing or partial observations stay distinguishable.
|
|
37
37
|
|
|
38
|
-
Rendering uses Claude Code input and local state without making network requests or using model tokens. The question-and-answer wizard uses Claude model turns. See [field definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
38
|
+
Rendering uses Claude Code input and local state without making network requests or using model tokens. The question-and-answer wizard uses Claude model turns. See [field definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/DISPLAY_ITEMS.md) for data sources and availability.
|
|
39
39
|
|
|
40
40
|
<a id="界面预览"></a>
|
|
41
41
|
|
|
42
42
|
## Screenshots
|
|
43
43
|
|
|
44
|
-
[Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
44
|
+
[Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/composition/README.md).
|
|
45
45
|
|
|
46
|
-
[Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
46
|
+
[Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/README.md#discovery-and-import-review).
|
|
47
47
|
|
|
48
48
|
|
|
49
|
-
The main status line at the bottom of session screenshots shows actual data; configuration Preview regions use fixed samples. Fonts, colors and widths depend on terminal settings. [Image sources and archive](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
49
|
+
The main status line at the bottom of session screenshots shows actual data; configuration Preview regions use fixed samples. Fonts, colors and widths depend on terminal settings. [Image sources and archive](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/README.md).
|
|
50
50
|
|
|
51
51
|
<details>
|
|
52
52
|
<summary>English / 简体中文 configuration</summary>
|
|
53
53
|
|
|
54
|
-
Linux terminal captures show the shared language selector and Chinese interface. These are reconstructions of actual PTY cells with sample previews; [sources and all pages](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
54
|
+
Linux terminal captures show the shared language selector and Chinese interface. These are reconstructions of actual PTY cells with sample previews; [sources and all pages](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/README.md#bilingual-terminal-captures).
|
|
55
55
|
|
|
56
|
-

|
|
57
57
|
|
|
58
|
-

|
|
59
59
|
|
|
60
|
-

|
|
61
61
|
|
|
62
62
|
</details>
|
|
63
63
|
|
|
64
64
|
### In-session TUI
|
|
65
65
|
|
|
66
|
-
Run `/statusline-configure-native` inside the current Claude Code session, then click the Client region once before using the keyboard. The editor follows the Claude theme; choose the preview background to match the terminal and compare the selected palette. [Compare terminal/theme combinations](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
66
|
+
Run `/statusline-configure-native` inside the current Claude Code session, then click the Client region once before using the keyboard. The editor follows the Claude theme; choose the preview background to match the terminal and compare the selected palette. [Compare terminal/theme combinations](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/development/native.md#terminal-background-previews).
|
|
67
67
|
|
|
68
68
|
**Linux: Main and the status line**
|
|
69
69
|
|
|
70
|
-

|
|
71
71
|
|
|
72
72
|
<details>
|
|
73
73
|
<summary>Linux: Subagents, Settings, Layout</summary>
|
|
74
74
|
|
|
75
75
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
76
76
|
|
|
77
|
-

|
|
78
78
|
|
|
79
79
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
80
80
|
|
|
81
|
-

|
|
82
82
|
|
|
83
83
|
**Layout: set rows, item priorities and maximum widths.**
|
|
84
84
|
|
|
85
|
-

|
|
86
86
|
|
|
87
87
|
</details>
|
|
88
88
|
|
|
89
89
|
<details>
|
|
90
90
|
<summary>Linux: light and dark themes</summary>
|
|
91
91
|
|
|
92
|
-
Earlier theme captures used a dark preview surface; the current editor offers a separate light/dark preview choice. These images reconstruct real terminal cells. [Capture provenance](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
92
|
+
Earlier theme captures used a dark preview surface; the current editor offers a separate light/dark preview choice. These images reconstruct real terminal cells. [Capture provenance](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/README.md#theme-terminal-captures).
|
|
93
93
|
|
|
94
|
-

|
|
95
95
|
|
|
96
|
-

|
|
97
97
|
|
|
98
98
|
</details>
|
|
99
99
|
|
|
@@ -102,30 +102,30 @@ Earlier theme captures used a dark preview surface; the current editor offers a
|
|
|
102
102
|
|
|
103
103
|
**Main: select and reorder main status line items.**
|
|
104
104
|
|
|
105
|
-

|
|
106
106
|
|
|
107
107
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
108
108
|
|
|
109
|
-

|
|
110
110
|
|
|
111
111
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
112
112
|
|
|
113
|
-

|
|
114
114
|
|
|
115
115
|
**Layout: set rows, item priorities and maximum widths.**
|
|
116
116
|
|
|
117
|
-

|
|
118
118
|
|
|
119
119
|
</details>
|
|
120
120
|
|
|
121
121
|
<details>
|
|
122
122
|
<summary>macOS: Main</summary>
|
|
123
123
|
|
|
124
|
-
Only Main was supplied for this batch. The existing interaction limitation and checks are documented in [macOS mouse reporting and Client focus](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
124
|
+
Only Main was supplied for this batch. The existing interaction limitation and checks are documented in [macOS mouse reporting and Client focus](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#macos-mouse-reporting-and-client-focus).
|
|
125
125
|
|
|
126
126
|
**Main: select and reorder main status line items.**
|
|
127
127
|
|
|
128
|
-

|
|
129
129
|
|
|
130
130
|
</details>
|
|
131
131
|
|
|
@@ -136,19 +136,19 @@ Run `/statusline-configure` in Claude Code, or `claude-statusline configure` in
|
|
|
136
136
|
<details>
|
|
137
137
|
<summary>Linux: light/dark backgrounds and palette comparison</summary>
|
|
138
138
|
|
|
139
|
-
Previews use the current terminal background and selected palette. Compare `ansi` in Settings when `default` looks faint. These are terminal-output reconstructions from dedicated GNOME profiles; [capture sources](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
139
|
+
Previews use the current terminal background and selected palette. Compare `ansi` in Settings when `default` looks faint. These are terminal-output reconstructions from dedicated GNOME profiles; [capture sources](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/README.md#external-terminal-color-captures).
|
|
140
140
|
|
|
141
141
|
**Light background, Palette: default**
|
|
142
142
|
|
|
143
|
-

|
|
144
144
|
|
|
145
145
|
**Light background, Palette: ansi**
|
|
146
146
|
|
|
147
|
-

|
|
148
148
|
|
|
149
149
|
**Dark background, Palette: default**
|
|
150
150
|
|
|
151
|
-

|
|
152
152
|
|
|
153
153
|
</details>
|
|
154
154
|
|
|
@@ -157,19 +157,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
|
|
|
157
157
|
|
|
158
158
|
**Main: select and reorder main status line items.**
|
|
159
159
|
|
|
160
|
-

|
|
161
161
|
|
|
162
162
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
163
163
|
|
|
164
|
-

|
|
165
165
|
|
|
166
166
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
167
167
|
|
|
168
|
-

|
|
169
169
|
|
|
170
170
|
**Layout: set rows, item priorities and maximum widths.**
|
|
171
171
|
|
|
172
|
-

|
|
173
173
|
|
|
174
174
|
</details>
|
|
175
175
|
|
|
@@ -178,19 +178,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
|
|
|
178
178
|
|
|
179
179
|
**Main: select and reorder main status line items.**
|
|
180
180
|
|
|
181
|
-

|
|
182
182
|
|
|
183
183
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
184
184
|
|
|
185
|
-

|
|
186
186
|
|
|
187
187
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
188
188
|
|
|
189
|
-

|
|
190
190
|
|
|
191
191
|
**Layout: set rows, item priorities and maximum widths.**
|
|
192
192
|
|
|
193
|
-

|
|
194
194
|
|
|
195
195
|
</details>
|
|
196
196
|
|
|
@@ -199,23 +199,23 @@ Previews use the current terminal background and selected palette. Compare `ansi
|
|
|
199
199
|
|
|
200
200
|
**Main: select and reorder main status line items.**
|
|
201
201
|
|
|
202
|
-

|
|
203
203
|
|
|
204
204
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
205
205
|
|
|
206
|
-

|
|
207
207
|
|
|
208
208
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
209
209
|
|
|
210
|
-

|
|
211
211
|
|
|
212
212
|
**Layout: set rows, item priorities and maximum widths.**
|
|
213
213
|
|
|
214
|
-

|
|
215
215
|
|
|
216
216
|
</details>
|
|
217
217
|
|
|
218
|
-
Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
218
|
+
Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/archive/README.md).
|
|
219
219
|
|
|
220
220
|
## Supported platforms
|
|
221
221
|
|
|
@@ -227,7 +227,7 @@ Earlier screenshots and terminal reconstructions remain in the [archive](https:/
|
|
|
227
227
|
|
|
228
228
|
Windows ARM devices use x64 Node under emulation; native Windows ARM64 and 32-bit runtimes are outside the current support contract. Git information requires `git`.
|
|
229
229
|
|
|
230
|
-
Claude Code feature requirements: subagent rows 2.1.205+; local argument-based configuration and external TUI entry 2.1.258+; in-session Client 2.1.287+; native timing and advanced live-metrics collection 2.1.289+. Unsupported or unknown host versions suspend the corresponding integration. See [requirements](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
230
|
+
Claude Code feature requirements: subagent rows 2.1.205+; local argument-based configuration and external TUI entry 2.1.258+; in-session Client 2.1.287+; native timing and advanced live-metrics collection 2.1.289+. Unsupported or unknown host versions suspend the corresponding integration. See [requirements](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#requirements).
|
|
231
231
|
|
|
232
232
|
<a id="install-current-source"></a>
|
|
233
233
|
<a id="install-from-a-release-recommended"></a>
|
|
@@ -245,11 +245,11 @@ Claude Code feature requirements: subagent rows 2.1.205+; local argument-based c
|
|
|
245
245
|
|
|
246
246
|
## Quick installation
|
|
247
247
|
|
|
248
|
-
Install Node 22.x or 24.x with npm and Claude Code CLI. One npm package includes the supported native dependencies and needs no Python or compiler. [Existing Python installation and rollback](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
248
|
+
Install Node 22.x or 24.x with npm and Claude Code CLI. One npm package includes the supported native dependencies and needs no Python or compiler. [Existing Python installation and rollback](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#upgrading).
|
|
249
249
|
|
|
250
250
|
### Install the package
|
|
251
251
|
|
|
252
|
-
For a reviewed installation in an interactive terminal, run `npx @fbincon/claude-code-statusline`. It verifies the durable global entry before opening setup. An installed `claude-statusline` without a subcommand opens the same flow. [Installation stages](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
252
|
+
For a reviewed installation in an interactive terminal, run `npx @fbincon/claude-code-statusline`. It verifies the durable global entry before opening setup. An installed `claude-statusline` without a subcommand opens the same flow. [Installation stages](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/SETUP.md).
|
|
253
253
|
|
|
254
254
|
Bash, Zsh, and PowerShell:
|
|
255
255
|
|
|
@@ -270,28 +270,28 @@ claude-statusline doctor
|
|
|
270
270
|
|
|
271
271
|
On Windows, use `claude-statusline.cmd`, or invoke the installed JavaScript entry with Node. Restart Claude Code in a trusted terminal after integration.
|
|
272
272
|
|
|
273
|
-
Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing and advanced live metrics both require explicit opt-in on compatible hosts; saved choices are preserved. Package installation and Claude integration are separate steps. `setup` connects checks, scheme preview and integration review; `install` remains the direct integration command. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
273
|
+
Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing and advanced live metrics both require explicit opt-in on compatible hosts; saved choices are preserved. Package installation and Claude integration are separate steps. `setup` connects checks, scheme preview and integration review; `install` remains the direct integration command. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
|
|
274
274
|
|
|
275
275
|
<details>
|
|
276
276
|
<summary>Other installation methods</summary>
|
|
277
277
|
|
|
278
|
-
Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
278
|
+
Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/development/README.md#build-and-install-from-source). Release attachments support offline npm installation; the installation guide covers fixed versions and Python recovery.
|
|
279
279
|
|
|
280
|
-
Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
280
|
+
Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/development/README.md#build-and-install-from-source).
|
|
281
281
|
|
|
282
282
|
</details>
|
|
283
283
|
|
|
284
284
|
## Common configuration
|
|
285
285
|
|
|
286
|
-
In either editor, use **Ctrl+P** or **Settings → Quick setup** to choose a use case, appearance and sample before editing or saving. Text fields support grapheme cursor editing. Item details explain configuration, requirements and sample fitting. See [quick setup and explanation](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
286
|
+
In either editor, use **Ctrl+P** or **Settings → Quick setup** to choose a use case, appearance and sample before editing or saving. Text fields support grapheme cursor editing. Item details explain configuration, requirements and sample fitting. See [quick setup and explanation](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#quick-setup-and-explanation).
|
|
287
287
|
|
|
288
|
-
[Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
288
|
+
[Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#item-discovery-import-review).
|
|
289
289
|
|
|
290
290
|
|
|
291
291
|
| Entry point | Use |
|
|
292
292
|
| --- | --- |
|
|
293
|
-
| `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
294
|
-
| `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
293
|
+
| `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#native-configuration-editor) |
|
|
294
|
+
| `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
|
|
295
295
|
| `claude-statusline configure` | Full TUI in the current standalone terminal |
|
|
296
296
|
| `/statusline-config` | Claude question-and-answer wizard; supported argument-based commands execute locally on compatible hosts |
|
|
297
297
|
| `claude-statusline config ...` | Inspect settings, set exact ordering, or configure from scripts |
|
|
@@ -309,7 +309,7 @@ claude-statusline config language reset
|
|
|
309
309
|
claude-statusline --language en --help
|
|
310
310
|
```
|
|
311
311
|
|
|
312
|
-
`--language en|zh-CN|zh-TW|zh-HK|ja|ko` precedes the command and affects only that invocation; for `configure` it sets the initial language. Commands, IDs, configuration values and custom text retain their values. Interface language does not change output language. See [language settings](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
312
|
+
`--language en|zh-CN|zh-TW|zh-HK|ja|ko` precedes the command and affects only that invocation; for `configure` it sets the initial language. Commands, IDs, configuration values and custom text retain their values. Interface language does not change output language. See [language settings](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#interface-language).
|
|
313
313
|
|
|
314
314
|
### Statusline language
|
|
315
315
|
|
|
@@ -320,13 +320,13 @@ claude-statusline config set statusline-language zh-TW
|
|
|
320
320
|
claude-statusline config set statusline-language en
|
|
321
321
|
```
|
|
322
322
|
|
|
323
|
-

|
|
324
324
|
|
|
325
|
-

|
|
326
326
|
|
|
327
|
-
These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
327
|
+
These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/images/README.md#statusline-language-captures).
|
|
328
328
|
|
|
329
|
-
Built-in labels and known states are translated. Technical units, model names, branches, paths and custom text are preserved. See [output language](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
329
|
+
Built-in labels and known states are translated. Technical units, model names, branches, paths and custom text are preserved. See [output language](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#statusline-language).
|
|
330
330
|
|
|
331
331
|
### Native configuration editor
|
|
332
332
|
|
|
@@ -346,7 +346,7 @@ claude-statusline config set directory-style home
|
|
|
346
346
|
claude-statusline config show
|
|
347
347
|
```
|
|
348
348
|
|
|
349
|
-
Configuration is per user. `set-items` replaces the enabled set; `enable` and `disable` make incremental changes. See [recipes](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
349
|
+
Configuration is per user. `set-items` replaces the enabled set; `enable` and `disable` make incremental changes. See [recipes](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/reference/cli.md).
|
|
350
350
|
|
|
351
351
|
<a id="upgrade-to-v161"></a>
|
|
352
352
|
|
|
@@ -360,7 +360,7 @@ claude-statusline update
|
|
|
360
360
|
claude-statusline doctor
|
|
361
361
|
```
|
|
362
362
|
|
|
363
|
-
Use [package management](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
363
|
+
Use [package management](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/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.9.2/docs/USER_GUIDE.md#migrate-the-previous-distribution-name). Saved display settings, runtime state, and integration preferences remain.
|
|
364
364
|
|
|
365
365
|
Remove Claude integration before uninstalling the package:
|
|
366
366
|
|
|
@@ -370,7 +370,7 @@ claude-statusline uninstall
|
|
|
370
370
|
npm uninstall --global @fbincon/claude-code-statusline
|
|
371
371
|
```
|
|
372
372
|
|
|
373
|
-
Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
373
|
+
Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md#uninstalling).
|
|
374
374
|
|
|
375
375
|
## Project structure
|
|
376
376
|
|
|
@@ -429,21 +429,21 @@ claude-code-statusline/
|
|
|
429
429
|
|
|
430
430
|
## Documentation and help
|
|
431
431
|
|
|
432
|
-
- [First-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
433
|
-
- [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
434
|
-
- [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
435
|
-
- [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
436
|
-
- [Development roadmap](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
437
|
-
- [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
438
|
-
- [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
432
|
+
- [First-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/SETUP.md) · [Three complete schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/SCHEMES.md) · [Appearance controls](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/APPEARANCE.md).
|
|
433
|
+
- [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
|
|
434
|
+
- [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/reference/cli.md): commands, options, fields, files, and exit codes.
|
|
435
|
+
- [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
|
|
436
|
+
- [Development roadmap](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/development/roadmap.md) · [Work-package plan](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/development/development-plan.md).
|
|
437
|
+
- [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/docs/RELEASING.md).
|
|
438
|
+
- [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
|
|
439
439
|
- [GitHub Issues](https://github.com/fbincon/claude-code-statusline/issues): include versions, reproduction steps, and diagnostic results; remove private paths and session content.
|
|
440
440
|
|
|
441
441
|
## Contributing and security
|
|
442
442
|
|
|
443
|
-
See the [contribution guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
443
|
+
See the [contribution guide](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/CONTRIBUTING.md) for development, translations and feedback. Report potential vulnerabilities privately using the [security policy](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/SECURITY.md).
|
|
444
444
|
|
|
445
445
|
## License
|
|
446
446
|
|
|
447
|
-
[MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
447
|
+
[MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
|
|
448
448
|
|
|
449
|
-
Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.9.
|
|
449
|
+
Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.9.2/tools/unicode/WCWIDTH-LICENSE.txt).
|