@fbincon/claude-code-statusline 3.1.4 → 3.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +75 -69
- package/candidate.json +273 -210
- package/node_modules/@fbincon/statusline-cli/dist/src/config/commands.js +2 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/config/commands.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/command.d.ts +10 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/command.js +100 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/command.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/observations.d.ts +8 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/observations.js +233 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/observations.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.d.ts +12 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.js +65 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/help.js +4 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/help.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/main.js +14 -6
- package/node_modules/@fbincon/statusline-cli/dist/src/main.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/rendering/preview.js +3 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/rendering/preview.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/runtime/usage.d.ts +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/runtime/usage.js +1 -8
- package/node_modules/@fbincon/statusline-cli/dist/src/runtime/usage.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/explain.d.ts +4 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/explain.js +27 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/explain.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.d.ts +7 -4
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js +20 -3
- 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 +12 -9
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/backend.ts +40 -2
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/keys.ts +35 -19
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/messages.ts +12 -8
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/settings.ts +2 -1
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/draft.ts +5 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/explanation.ts +35 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/quick-setup.ts +82 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/text-input.ts +68 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/generated-contracts.ts +66 -6
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/generated-locales.ts +834 -12
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/session.ts +7 -4
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/resource-manifest.json +19 -16
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/draw.ts +25 -6
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/help.ts +6 -3
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/surface.ts +16 -3
- 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/config/catalog-data.js +46 -4
- package/node_modules/@fbincon/statusline-core/dist/src/config/catalog-data.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/config/presets.d.ts +7 -0
- package/node_modules/@fbincon/statusline-core/dist/src/config/presets.js +5 -0
- package/node_modules/@fbincon/statusline-core/dist/src/config/presets.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.d.ts +32 -14
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.js +2 -2
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.d.ts +127 -17
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js +5 -1
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/backend.js +50 -2
- 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 +4 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js +3 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/explanation.d.ts +13 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/explanation.js +41 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/explanation.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.d.ts +21 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.js +105 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/text-input.d.ts +32 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/text-input.js +89 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/text-input.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.d.ts +828 -6
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js +834 -12
- 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 +9 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/en.js +10 -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 +9 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ja.js +10 -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 +9 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/ko.js +10 -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 +9 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-CN.js +10 -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 +9 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-HK.js +10 -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 +9 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/statusline/zh-TW.js +10 -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/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/components.d.ts +3 -2
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.js +8 -3
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/context.d.ts +7 -3
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/diagnose.d.ts +15 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/diagnose.js +110 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/diagnose.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/explain.d.ts +15 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/explain.js +42 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/explain.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/host-fields.d.ts +18 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/host-fields.js +54 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/host-fields.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js +29 -11
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.d.ts +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.js +7 -2
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/preview.js +2 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/preview.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js +35 -12
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.d.ts +14 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.js +36 -0
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/trace.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/requests.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/requests.js +4 -0
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/requests.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/snapshot.d.ts +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/snapshot.js +11 -4
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/live/snapshot.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/usage.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/usage.js +9 -0
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/usage.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/terminal/key.d.ts +2 -0
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/en.json +139 -2
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ja.json +139 -2
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ko.json +139 -2
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-CN.json +139 -2
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-HK.json +139 -2
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-TW.json +139 -2
- package/node_modules/@fbincon/statusline-platform/dist/src/diagnostic-files.d.ts +7 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/diagnostic-files.js +29 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/diagnostic-files.js.map +1 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/terminal/input.d.ts +2 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/terminal/input.js +11 -3
- package/node_modules/@fbincon/statusline-platform/dist/src/terminal/input.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js +15 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/presentation.js +4 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/presentation.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js +15 -5
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/shortcuts.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing.js +3 -3
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing.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 +40 -3
- package/node_modules/@fbincon/statusline-tui/dist/src/session.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/state.d.ts +6 -2
- package/node_modules/@fbincon/statusline-tui/dist/src/state.js +87 -40
- package/node_modules/@fbincon/statusline-tui/dist/src/state.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
# Claude Code Statusline
|
|
2
2
|
|
|
3
|
-
**English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
3
|
+
**English** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/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.
|
|
7
|
+
[MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/LICENSE)
|
|
8
8
|
|
|
9
9
|
A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reasoning effort, directory, Git, context, usage limits, tokens, and task timing at a glance. Configure the main line and individual subagent rows through an in-session editor, a terminal UI, a wizard, or the CLI.
|
|
10
10
|
|
|
11
|
-
[Features](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
11
|
+
[Features](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#troubleshooting)
|
|
12
12
|
|
|
13
13
|
<a id="phase-4-in-stable-v150"></a>
|
|
14
14
|
<a id="phase-5-in-stable-v160"></a>
|
|
@@ -16,10 +16,11 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
|
|
|
16
16
|
|
|
17
17
|
## Features
|
|
18
18
|
|
|
19
|
-
- **Compose your statusline:** add, copy and arrange independent components, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
20
|
-
- **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors and themes, and opt into basic [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
21
|
-
- **Choose your languages:** English, 简体中文, 繁體中文, 日本語 and 한국어 for interfaces and actual statusline output, independently; interface changes save immediately, output language saves with display settings. See [language examples](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
22
|
-
- **
|
|
19
|
+
- **Compose your statusline:** add, copy and arrange independent components, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/COMPOSITION.md).
|
|
20
|
+
- **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors and themes, and opt into basic [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/APPEARANCE.md).
|
|
21
|
+
- **Choose your languages:** English, 简体中文, 繁體中文, 日本語 and 한국어 for interfaces and actual statusline output, independently; interface changes save immediately, output language saves with display settings. See [language examples](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/images/languages/README.md).
|
|
22
|
+
- **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.3.0/docs/DIAGNOSTICS.md).
|
|
23
|
+
- **Find what to show:** 61 main metrics and 14 subagent metrics, plus text and flexible spacers, with ranked multilingual search, category filters and source/requirement guidance.
|
|
23
24
|
- **Track the right scope:** session token totals, per-task subagent rows, and total task time covering queueing, agents and main-agent wrap-up; optional execution time excludes verified user waits.
|
|
24
25
|
- **Adjust presentation:** model and number formats, labels, built-in icons, colors, directory styles, and automatic or explicit rows with priorities and width limits.
|
|
25
26
|
- **Keep Unicode intact:** joined emoji, combining marks and CJK text stay together when rows wrap, clip or appear in previews.
|
|
@@ -29,65 +30,65 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
|
|
|
29
30
|
- **Follow terminal colors:** external TUI text and bold keys use terminal defaults, with cyan headings; previews show the selected palette on the current terminal background.
|
|
30
31
|
- **Enable optional live metrics:** runtime state, agent count, tool progress, request timing, and per-task usage are opt-in. Missing or partial observations stay distinguishable.
|
|
31
32
|
|
|
32
|
-
Rendering uses Claude Code input and local state without making network requests or using model tokens. The question-and-answer wizard uses Claude model turns. See [field definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
33
|
+
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.3.0/docs/DISPLAY_ITEMS.md) for data sources and availability.
|
|
33
34
|
|
|
34
35
|
<a id="界面预览"></a>
|
|
35
36
|
|
|
36
37
|
## Screenshots
|
|
37
38
|
|
|
38
|
-
[Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
39
|
+
[Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/images/composition/README.md).
|
|
39
40
|
|
|
40
|
-
[Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
41
|
+
[Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/images/README.md#discovery-and-import-review).
|
|
41
42
|
|
|
42
43
|
|
|
43
|
-
The main status line at the bottom of session screenshots shows actual data; configuration Preview regions use fixed samples. Fonts, colors and widths depend on terminal settings. [Image sources and archive](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
44
|
+
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.3.0/docs/images/README.md).
|
|
44
45
|
|
|
45
46
|
<details>
|
|
46
47
|
<summary>English / 简体中文 configuration</summary>
|
|
47
48
|
|
|
48
|
-
Linux terminal captures show the shared language selector and Chinese interface. These are reconstructions of actual PTY cells with sample previews; [sources and all pages](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
49
|
+
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.3.0/docs/images/README.md#bilingual-terminal-captures).
|
|
49
50
|
|
|
50
|
-

|
|
51
52
|
|
|
52
|
-

|
|
53
54
|
|
|
54
|
-

|
|
55
56
|
|
|
56
57
|
</details>
|
|
57
58
|
|
|
58
59
|
### In-session TUI
|
|
59
60
|
|
|
60
|
-
Run `/statusline-configure-native` inside the current Claude Code session, then click the Client region once before using the keyboard. The editor follows the Claude theme; choose the preview background to match the terminal and compare the selected palette. [Compare terminal/theme combinations](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
61
|
+
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.3.0/docs/development/native.md#terminal-background-previews).
|
|
61
62
|
|
|
62
63
|
**Linux: Main and the status line**
|
|
63
64
|
|
|
64
|
-

|
|
65
66
|
|
|
66
67
|
<details>
|
|
67
68
|
<summary>Linux: Subagents, Settings, Layout</summary>
|
|
68
69
|
|
|
69
70
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
70
71
|
|
|
71
|
-

|
|
72
73
|
|
|
73
74
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
74
75
|
|
|
75
|
-

|
|
76
77
|
|
|
77
78
|
**Layout: set rows, item priorities and maximum widths.**
|
|
78
79
|
|
|
79
|
-

|
|
80
81
|
|
|
81
82
|
</details>
|
|
82
83
|
|
|
83
84
|
<details>
|
|
84
85
|
<summary>Linux: light and dark themes</summary>
|
|
85
86
|
|
|
86
|
-
Earlier theme captures used a dark preview surface; the current editor offers a separate light/dark preview choice. These images reconstruct real terminal cells. [Capture provenance](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
87
|
+
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.3.0/docs/images/README.md#theme-terminal-captures).
|
|
87
88
|
|
|
88
|
-

|
|
89
90
|
|
|
90
|
-

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

|
|
100
101
|
|
|
101
102
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
102
103
|
|
|
103
|
-

|
|
104
105
|
|
|
105
106
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
106
107
|
|
|
107
|
-

|
|
108
109
|
|
|
109
110
|
**Layout: set rows, item priorities and maximum widths.**
|
|
110
111
|
|
|
111
|
-

|
|
112
113
|
|
|
113
114
|
</details>
|
|
114
115
|
|
|
115
116
|
<details>
|
|
116
117
|
<summary>macOS: Main</summary>
|
|
117
118
|
|
|
118
|
-
Only Main was supplied for this batch. The existing interaction limitation and checks are documented in [macOS mouse reporting and Client focus](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
119
|
+
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.3.0/docs/USER_GUIDE.md#macos-mouse-reporting-and-client-focus).
|
|
119
120
|
|
|
120
121
|
**Main: select and reorder main status line items.**
|
|
121
122
|
|
|
122
|
-

|
|
123
124
|
|
|
124
125
|
</details>
|
|
125
126
|
|
|
@@ -130,19 +131,19 @@ Run `/statusline-configure` in Claude Code, or `claude-statusline configure` in
|
|
|
130
131
|
<details>
|
|
131
132
|
<summary>Linux: light/dark backgrounds and palette comparison</summary>
|
|
132
133
|
|
|
133
|
-
Previews use the current terminal background and selected palette. Compare `ansi` in Settings when `default` looks faint. These are terminal-output reconstructions from dedicated GNOME profiles; [capture sources](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
134
|
+
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.3.0/docs/images/README.md#external-terminal-color-captures).
|
|
134
135
|
|
|
135
136
|
**Light background, Palette: default**
|
|
136
137
|
|
|
137
|
-

|
|
138
139
|
|
|
139
140
|
**Light background, Palette: ansi**
|
|
140
141
|
|
|
141
|
-

|
|
142
143
|
|
|
143
144
|
**Dark background, Palette: default**
|
|
144
145
|
|
|
145
|
-

|
|
146
147
|
|
|
147
148
|
</details>
|
|
148
149
|
|
|
@@ -151,19 +152,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
|
|
|
151
152
|
|
|
152
153
|
**Main: select and reorder main status line items.**
|
|
153
154
|
|
|
154
|
-

|
|
155
156
|
|
|
156
157
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
157
158
|
|
|
158
|
-

|
|
159
160
|
|
|
160
161
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
161
162
|
|
|
162
|
-

|
|
163
164
|
|
|
164
165
|
**Layout: set rows, item priorities and maximum widths.**
|
|
165
166
|
|
|
166
|
-

|
|
167
168
|
|
|
168
169
|
</details>
|
|
169
170
|
|
|
@@ -172,19 +173,19 @@ Previews use the current terminal background and selected palette. Compare `ansi
|
|
|
172
173
|
|
|
173
174
|
**Main: select and reorder main status line items.**
|
|
174
175
|
|
|
175
|
-

|
|
176
177
|
|
|
177
178
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
178
179
|
|
|
179
|
-

|
|
180
181
|
|
|
181
182
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
182
183
|
|
|
183
|
-

|
|
184
185
|
|
|
185
186
|
**Layout: set rows, item priorities and maximum widths.**
|
|
186
187
|
|
|
187
|
-

|
|
188
189
|
|
|
189
190
|
</details>
|
|
190
191
|
|
|
@@ -193,23 +194,23 @@ Previews use the current terminal background and selected palette. Compare `ansi
|
|
|
193
194
|
|
|
194
195
|
**Main: select and reorder main status line items.**
|
|
195
196
|
|
|
196
|
-

|
|
197
198
|
|
|
198
199
|
**Subagents: choose items and ordering for individual agent rows.**
|
|
199
200
|
|
|
200
|
-

|
|
201
202
|
|
|
202
203
|
**Settings: adjust appearance, refresh behavior and formatting.**
|
|
203
204
|
|
|
204
|
-

|
|
205
206
|
|
|
206
207
|
**Layout: set rows, item priorities and maximum widths.**
|
|
207
208
|
|
|
208
|
-

|
|
209
210
|
|
|
210
211
|
</details>
|
|
211
212
|
|
|
212
|
-
Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
213
|
+
Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/images/archive/README.md).
|
|
213
214
|
|
|
214
215
|
## Supported platforms
|
|
215
216
|
|
|
@@ -221,7 +222,7 @@ Earlier screenshots and terminal reconstructions remain in the [archive](https:/
|
|
|
221
222
|
|
|
222
223
|
Windows ARM devices use x64 Node under emulation; native Windows ARM64 and 32-bit runtimes are outside the current support contract. Git information requires `git`.
|
|
223
224
|
|
|
224
|
-
Claude Code feature requirements: subagent rows 2.1.205+; local argument-based configuration and external TUI entry 2.1.258+; in-session Client 2.1.287+; native timing and advanced live-metrics collection 2.1.289+. Unsupported or unknown host versions suspend the corresponding integration. See [requirements](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
225
|
+
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.3.0/docs/USER_GUIDE.md#requirements).
|
|
225
226
|
|
|
226
227
|
<a id="install-current-source"></a>
|
|
227
228
|
<a id="install-from-a-release-recommended"></a>
|
|
@@ -239,7 +240,7 @@ Claude Code feature requirements: subagent rows 2.1.205+; local argument-based c
|
|
|
239
240
|
|
|
240
241
|
## Quick installation
|
|
241
242
|
|
|
242
|
-
Install Node 22.x or 24.x with npm and Claude Code CLI. One npm package includes the supported native dependencies and needs no Python or compiler. [Existing Python installation and rollback](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
243
|
+
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.3.0/docs/USER_GUIDE.md#upgrading).
|
|
243
244
|
|
|
244
245
|
### Install the package
|
|
245
246
|
|
|
@@ -262,26 +263,28 @@ claude-statusline doctor
|
|
|
262
263
|
|
|
263
264
|
On Windows, use `claude-statusline.cmd`, or invoke the installed JavaScript entry with Node. Restart Claude Code in a trusted terminal after integration.
|
|
264
265
|
|
|
265
|
-
Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing and advanced live metrics both require explicit opt-in on compatible hosts; saved choices are preserved. Package installation and Claude integration are separate steps; `install` does not open an editor. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
266
|
+
Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing and advanced live metrics both require explicit opt-in on compatible hosts; saved choices are preserved. Package installation and Claude integration are separate steps; `install` does not open an editor. Existing conflicting resources require [explicit handling](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
|
|
266
267
|
|
|
267
268
|
<details>
|
|
268
269
|
<summary>Other installation methods</summary>
|
|
269
270
|
|
|
270
|
-
Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
271
|
+
Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/development/README.md#build-and-install-from-source). Release attachments support offline npm installation; the installation guide covers fixed versions and Python recovery.
|
|
271
272
|
|
|
272
|
-
Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
273
|
+
Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/development/README.md#build-and-install-from-source).
|
|
273
274
|
|
|
274
275
|
</details>
|
|
275
276
|
|
|
276
277
|
## Common configuration
|
|
277
278
|
|
|
278
|
-
|
|
279
|
+
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.3.0/docs/USER_GUIDE.md#quick-setup-and-explanation).
|
|
280
|
+
|
|
281
|
+
[Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#item-discovery-import-review).
|
|
279
282
|
|
|
280
283
|
|
|
281
284
|
| Entry point | Use |
|
|
282
285
|
| --- | --- |
|
|
283
|
-
| `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
284
|
-
| `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
286
|
+
| `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#native-configuration-editor) |
|
|
287
|
+
| `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
|
|
285
288
|
| `claude-statusline configure` | Full TUI in the current standalone terminal |
|
|
286
289
|
| `/statusline-config` | Claude question-and-answer wizard; supported argument-based commands execute locally on compatible hosts |
|
|
287
290
|
| `claude-statusline config ...` | Inspect settings, set exact ordering, or configure from scripts |
|
|
@@ -299,7 +302,7 @@ claude-statusline config language reset
|
|
|
299
302
|
claude-statusline --language en --help
|
|
300
303
|
```
|
|
301
304
|
|
|
302
|
-
`--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.
|
|
305
|
+
`--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.3.0/docs/USER_GUIDE.md#interface-language).
|
|
303
306
|
|
|
304
307
|
### Statusline language
|
|
305
308
|
|
|
@@ -310,13 +313,13 @@ claude-statusline config set statusline-language zh-TW
|
|
|
310
313
|
claude-statusline config set statusline-language en
|
|
311
314
|
```
|
|
312
315
|
|
|
313
|
-

|
|
314
317
|
|
|
315
|
-

|
|
316
319
|
|
|
317
|
-
These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
320
|
+
These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/images/README.md#statusline-language-captures).
|
|
318
321
|
|
|
319
|
-
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.
|
|
322
|
+
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.3.0/docs/USER_GUIDE.md#statusline-language).
|
|
320
323
|
|
|
321
324
|
### Native configuration editor
|
|
322
325
|
|
|
@@ -336,7 +339,7 @@ claude-statusline config set directory-style home
|
|
|
336
339
|
claude-statusline config show
|
|
337
340
|
```
|
|
338
341
|
|
|
339
|
-
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.
|
|
342
|
+
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.3.0/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/reference/cli.md).
|
|
340
343
|
|
|
341
344
|
<a id="upgrade-to-v161"></a>
|
|
342
345
|
|
|
@@ -350,7 +353,7 @@ claude-statusline install
|
|
|
350
353
|
claude-statusline doctor
|
|
351
354
|
```
|
|
352
355
|
|
|
353
|
-
Existing Python installations should first follow the [migration and rollback procedure](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
356
|
+
Existing Python installations should first follow the [migration and rollback procedure](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#migrate-the-previous-distribution-name). Saved display settings, runtime state, and integration preferences remain. For older display schemas or package downgrade, follow [version compatibility](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#version-compatibility).
|
|
354
357
|
|
|
355
358
|
Remove Claude integration before uninstalling the package:
|
|
356
359
|
|
|
@@ -360,7 +363,7 @@ claude-statusline uninstall
|
|
|
360
363
|
npm uninstall --global @fbincon/claude-code-statusline
|
|
361
364
|
```
|
|
362
365
|
|
|
363
|
-
Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
366
|
+
Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md#uninstalling).
|
|
364
367
|
|
|
365
368
|
## Project structure
|
|
366
369
|
|
|
@@ -371,6 +374,9 @@ claude-code-statusline/
|
|
|
371
374
|
│ └── reference.yml # Manual historical Python verification
|
|
372
375
|
├── packages/ # Four business packages
|
|
373
376
|
│ ├── core/src/ # Configuration, protocols, pure state, rendering and Unicode
|
|
377
|
+
│ │ ├── editor/ # Shared drafts, cursor input, quick setup and explanations
|
|
378
|
+
│ │ ├── rendering/ # Rendering, fitting and optional explanation records
|
|
379
|
+
│ │ ├── contracts/ # Independently versioned editor/runtime interfaces
|
|
374
380
|
│ │ └── i18n/ # Registry-generated languages; sources in core/resources
|
|
375
381
|
│ ├── platform/src/ # Files, locks, processes, clocks and terminal adapters
|
|
376
382
|
│ ├── cli/ # Commands, integration, runtime and recovery
|
|
@@ -407,15 +413,15 @@ claude-code-statusline/
|
|
|
407
413
|
|
|
408
414
|
## Documentation and help
|
|
409
415
|
|
|
410
|
-
- [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
411
|
-
- [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
412
|
-
- [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
413
|
-
- [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
414
|
-
- [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
416
|
+
- [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
|
|
417
|
+
- [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/reference/cli.md): commands, options, fields, files, and exit codes.
|
|
418
|
+
- [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
|
|
419
|
+
- [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/docs/RELEASING.md).
|
|
420
|
+
- [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
|
|
415
421
|
- [GitHub Issues](https://github.com/fbincon/claude-code-statusline/issues): include versions, reproduction steps, and diagnostic results; remove private paths and session content.
|
|
416
422
|
|
|
417
423
|
## License
|
|
418
424
|
|
|
419
|
-
[MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
425
|
+
[MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
|
|
420
426
|
|
|
421
|
-
Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
427
|
+
Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.3.0/tools/unicode/WCWIDTH-LICENSE.txt).
|