@fbincon/claude-code-statusline 3.3.0 → 3.5.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 +78 -73
- package/candidate.json +291 -215
- package/node_modules/@fbincon/statusline-cli/dist/src/config/operations.js +5 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/operations.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/config/profile-command.d.ts +12 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/profile-command.js +101 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/profile-command.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/profiles.d.ts +54 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/profiles.js +199 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/profiles.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/service.d.ts +2 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/service.js +19 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/config/service.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/config/transfer.d.ts +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/config/transfer.js +4 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/config/transfer.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/command.js +9 -2
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/command.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.d.ts +8 -2
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.js +6 -3
- package/node_modules/@fbincon/statusline-cli/dist/src/diagnostics/service.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/help.js +14 -2
- package/node_modules/@fbincon/statusline-cli/dist/src/help.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/arguments.js +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/arguments.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.d.ts +2 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.js +3 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/configure.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/install.js +6 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/install.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/model.d.ts +2 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/setup-service.d.ts +23 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/setup-service.js +168 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/setup-service.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/setup.d.ts +3 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/setup.js +64 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/integration/setup.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/main.js +35 -9
- package/node_modules/@fbincon/statusline-cli/dist/src/main.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/recovery/journal.js +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/recovery/journal.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/rendering/configuration.d.ts +12 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/rendering/configuration.js +59 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/rendering/configuration.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/rendering/main.js +15 -2
- package/node_modules/@fbincon/statusline-cli/dist/src/rendering/main.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.d.ts +3 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.js +25 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/tasks/command.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/tasks/service.d.ts +4 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/tasks/service.js +93 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/tasks/service.js.map +1 -0
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.d.ts +5 -3
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js +34 -8
- package/node_modules/@fbincon/statusline-cli/dist/src/ui/protocol.js.map +1 -1
- package/node_modules/@fbincon/statusline-cli/resources/statusline-config/SKILL.md +5 -0
- 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 +89 -3
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/backend.ts +61 -7
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/client/keys.ts +8 -1
- 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/draft.ts +2 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/profile-manager.ts +258 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/quick-setup.ts +14 -11
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/setup.ts +60 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/editor/task-detail.ts +27 -0
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/generated-contracts.ts +552 -6
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/i18n/generated-locales.ts +1194 -6
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/lib/session.ts +2 -1
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/resource-manifest.json +18 -15
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/draw.ts +7 -3
- package/node_modules/@fbincon/statusline-cli/resources/statusline-native/ui/client/help.ts +1 -0
- 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/defaults.d.ts +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/config/defaults.js +5 -2
- package/node_modules/@fbincon/statusline-core/dist/src/config/defaults.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/config/display.d.ts +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/config/display.js +12 -10
- package/node_modules/@fbincon/statusline-core/dist/src/config/display.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/config/formatting.d.ts +3 -0
- package/node_modules/@fbincon/statusline-core/dist/src/config/formatting.js +11 -0
- package/node_modules/@fbincon/statusline-core/dist/src/config/formatting.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/config/presets.d.ts +4 -0
- package/node_modules/@fbincon/statusline-core/dist/src/config/presets.js +37 -3
- package/node_modules/@fbincon/statusline-core/dist/src/config/presets.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/config/profiles.d.ts +16 -0
- package/node_modules/@fbincon/statusline-core/dist/src/config/profiles.js +69 -0
- package/node_modules/@fbincon/statusline-core/dist/src/config/profiles.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.d.ts +24 -0
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/generated-catalog.js +1 -1
- 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 +212 -4
- package/node_modules/@fbincon/statusline-core/dist/src/contracts/ui.js +485 -2
- 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 +78 -7
- 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 +2 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/draft.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/profile-manager.d.ts +63 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/profile-manager.js +355 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/profile-manager.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.d.ts +4 -4
- package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.js +16 -9
- package/node_modules/@fbincon/statusline-core/dist/src/editor/quick-setup.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/editor/setup.d.ts +30 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/setup.js +96 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/setup.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/task-detail.d.ts +4 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/task-detail.js +25 -0
- package/node_modules/@fbincon/statusline-core/dist/src/editor/task-detail.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.d.ts +1188 -0
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.js +1194 -6
- package/node_modules/@fbincon/statusline-core/dist/src/i18n/generated-locales.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/appearance.d.ts +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/appearance.js +24 -2
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/appearance.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.d.ts +3 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.js +18 -5
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/components.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/items.js +4 -4
- 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 +15 -5
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.js +78 -48
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/powerline.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/preferences.js +6 -0
- 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 +3 -3
- package/node_modules/@fbincon/statusline-core/dist/src/rendering/subagents.js.map +1 -1
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/tasks/details.d.ts +24 -0
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/tasks/details.js +153 -0
- package/node_modules/@fbincon/statusline-core/dist/src/runtime/tasks/details.js.map +1 -0
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/en.json +199 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ja.json +199 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/ko.json +199 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-CN.json +199 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-HK.json +199 -1
- package/node_modules/@fbincon/statusline-core/resources/i18n/locales/zh-TW.json +199 -1
- package/node_modules/@fbincon/statusline-platform/dist/src/project-paths.d.ts +8 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/project-paths.js +41 -0
- package/node_modules/@fbincon/statusline-platform/dist/src/project-paths.js.map +1 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing/pages.js +6 -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 +2 -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 +2 -0
- 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 -2
- package/node_modules/@fbincon/statusline-tui/dist/src/drawing.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/session.js +7 -3
- package/node_modules/@fbincon/statusline-tui/dist/src/session.js.map +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/setup.d.ts +12 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/setup.js +75 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/setup.js.map +1 -0
- package/node_modules/@fbincon/statusline-tui/dist/src/state.d.ts +1 -1
- package/node_modules/@fbincon/statusline-tui/dist/src/state.js +18 -2
- 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.5.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.5.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.5.0/README.md#features) · [Screenshots](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/README.md#screenshots) · [Quick installation](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/README.md#quick-installation) · [Common configuration](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/README.md#common-configuration) · [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md) · [Troubleshooting](https://github.com/fbincon/claude-code-statusline/blob/v3.5.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,79 +16,82 @@ A Claude Code status line for Linux, WSL, Windows, and macOS. See model and reas
|
|
|
16
16
|
|
|
17
17
|
## Features
|
|
18
18
|
|
|
19
|
-
- **
|
|
20
|
-
- **
|
|
21
|
-
|
|
22
|
-
- **
|
|
19
|
+
- **Reuse display schemes across projects:** save and preview named schemes, then bind project roots to complete display settings. [Profile guide](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/PROFILES.md).
|
|
20
|
+
- **Inspect task evidence:** open `/statusline-task` or the CLI for task, agent, timing-source and coverage details on demand. [Task details](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/TASK_DETAILS.md).
|
|
21
|
+
|
|
22
|
+
- **Compose your statusline:** add, copy and arrange independent components, literal text and left/right alignment in either editor. [Composition guide](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/COMPOSITION.md).
|
|
23
|
+
- **Control visibility and appearance:** hide confirmed empty/clean states, set usage thresholds, choose per-item foreground/background colors and themes, and opt into basic [Powerline](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/APPEARANCE.md).
|
|
24
|
+
- **Choose your languages:** English, 简体中文, 繁體中文, 日本語 and 한국어 for interfaces and actual statusline output, independently; interface changes save immediately, output language saves with display settings. See [language examples](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/images/languages/README.md).
|
|
25
|
+
- **Diagnose supplied input:** inspect real statusline JSON and matching saved observations without collecting or writing. See [input diagnosis](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/DIAGNOSTICS.md).
|
|
23
26
|
- **Find what to show:** 61 main metrics and 14 subagent metrics, plus text and flexible spacers, with ranked multilingual search, category filters and source/requirement guidance.
|
|
24
27
|
- **Track the right scope:** session token totals, per-task subagent rows, and total task time covering queueing, agents and main-agent wrap-up; optional execution time excludes verified user waits.
|
|
25
28
|
- **Adjust presentation:** model and number formats, labels, built-in icons, colors, directory styles, and automatic or explicit rows with priorities and width limits.
|
|
26
29
|
- **Keep Unicode intact:** joined emoji, combining marks and CJK text stay together when rows wrap, clip or appear in previews.
|
|
27
|
-
- **Review configuration changes:** six
|
|
30
|
+
- **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.
|
|
28
31
|
- **Choose an editor:** Main, Subagents, Settings, and Layout pages share the same configuration. Claude appearance and behavior preferences use a separate Apply action.
|
|
29
32
|
- **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.
|
|
30
33
|
- **Follow terminal colors:** external TUI text and bold keys use terminal defaults, with cyan headings; previews show the selected palette on the current terminal background.
|
|
31
34
|
- **Enable optional live metrics:** runtime state, agent count, tool progress, request timing, and per-task usage are opt-in. Missing or partial observations stay distinguishable.
|
|
32
35
|
|
|
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.
|
|
36
|
+
Rendering uses Claude Code input and local state without making network requests or using model tokens. The question-and-answer wizard uses Claude model turns. See [field definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/DISPLAY_ITEMS.md) for data sources and availability.
|
|
34
37
|
|
|
35
38
|
<a id="界面预览"></a>
|
|
36
39
|
|
|
37
40
|
## Screenshots
|
|
38
41
|
|
|
39
|
-
[Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
42
|
+
[Component instances, copies and left/right layout captures](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/images/composition/README.md).
|
|
40
43
|
|
|
41
|
-
[Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
44
|
+
[Search, categories, source guidance and import review captures](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/images/README.md#discovery-and-import-review).
|
|
42
45
|
|
|
43
46
|
|
|
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.
|
|
47
|
+
The main status line at the bottom of session screenshots shows actual data; configuration Preview regions use fixed samples. Fonts, colors and widths depend on terminal settings. [Image sources and archive](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/images/README.md).
|
|
45
48
|
|
|
46
49
|
<details>
|
|
47
50
|
<summary>English / 简体中文 configuration</summary>
|
|
48
51
|
|
|
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.
|
|
52
|
+
Linux terminal captures show the shared language selector and Chinese interface. These are reconstructions of actual PTY cells with sample previews; [sources and all pages](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/images/README.md#bilingual-terminal-captures).
|
|
50
53
|
|
|
51
|
-

|
|
52
55
|
|
|
53
|
-

|
|
54
57
|
|
|
55
|
-

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

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

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

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

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

|
|
90
93
|
|
|
91
|
-

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

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

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

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

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

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

|
|
139
142
|
|
|
140
143
|
**Light background, Palette: ansi**
|
|
141
144
|
|
|
142
|
-

|
|
143
146
|
|
|
144
147
|
**Dark background, Palette: default**
|
|
145
148
|
|
|
146
|
-

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

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

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

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

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

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

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

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

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

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

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

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

|
|
210
213
|
|
|
211
214
|
</details>
|
|
212
215
|
|
|
213
|
-
Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
216
|
+
Earlier screenshots and terminal reconstructions remain in the [archive](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/images/archive/README.md).
|
|
214
217
|
|
|
215
218
|
## Supported platforms
|
|
216
219
|
|
|
@@ -222,7 +225,7 @@ Earlier screenshots and terminal reconstructions remain in the [archive](https:/
|
|
|
222
225
|
|
|
223
226
|
Windows ARM devices use x64 Node under emulation; native Windows ARM64 and 32-bit runtimes are outside the current support contract. Git information requires `git`.
|
|
224
227
|
|
|
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.
|
|
228
|
+
Claude Code feature requirements: subagent rows 2.1.205+; local argument-based configuration and external TUI entry 2.1.258+; in-session Client 2.1.287+; native timing and advanced live-metrics collection 2.1.289+. Unsupported or unknown host versions suspend the corresponding integration. See [requirements](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#requirements).
|
|
226
229
|
|
|
227
230
|
<a id="install-current-source"></a>
|
|
228
231
|
<a id="install-from-a-release-recommended"></a>
|
|
@@ -240,7 +243,7 @@ Claude Code feature requirements: subagent rows 2.1.205+; local argument-based c
|
|
|
240
243
|
|
|
241
244
|
## Quick installation
|
|
242
245
|
|
|
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.
|
|
246
|
+
Install Node 22.x or 24.x with npm and Claude Code CLI. One npm package includes the supported native dependencies and needs no Python or compiler. [Existing Python installation and rollback](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#upgrading).
|
|
244
247
|
|
|
245
248
|
### Install the package
|
|
246
249
|
|
|
@@ -256,35 +259,35 @@ Ensure the npm command directory is on PATH, then run:
|
|
|
256
259
|
|
|
257
260
|
```text
|
|
258
261
|
claude-statusline --version
|
|
259
|
-
claude-statusline
|
|
260
|
-
claude-statusline
|
|
262
|
+
claude-statusline setup --dry-run
|
|
263
|
+
claude-statusline setup
|
|
261
264
|
claude-statusline doctor
|
|
262
265
|
```
|
|
263
266
|
|
|
264
267
|
On Windows, use `claude-statusline.cmd`, or invoke the installed JavaScript entry with Node. Restart Claude Code in a trusted terminal after integration.
|
|
265
268
|
|
|
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`
|
|
269
|
+
Both editors default on for compatible hosts, respecting saved disablement preferences. Native timing and advanced live metrics both require explicit opt-in on compatible hosts; saved choices are preserved. Package installation and Claude integration are separate steps. `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.5.0/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name).
|
|
267
270
|
|
|
268
271
|
<details>
|
|
269
272
|
<summary>Other installation methods</summary>
|
|
270
273
|
|
|
271
|
-
Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
274
|
+
Source development on main uses Node and TypeScript; follow the [source development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.5.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.
|
|
272
275
|
|
|
273
|
-
Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
276
|
+
Download checksums and platform-specific instructions are in the [installation guide](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#installation-and-integration); source builds are in the [development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/development/README.md#build-and-install-from-source).
|
|
274
277
|
|
|
275
278
|
</details>
|
|
276
279
|
|
|
277
280
|
## Common configuration
|
|
278
281
|
|
|
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.
|
|
282
|
+
In either editor, use **Ctrl+P** or **Settings → Quick setup** to choose a use case, appearance and sample before editing or saving. Text fields support grapheme cursor editing. Item details explain configuration, requirements and sample fitting. See [quick setup and explanation](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#quick-setup-and-explanation).
|
|
280
283
|
|
|
281
|
-
[Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
284
|
+
[Find items, understand their sources, and review imports](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#item-discovery-import-review).
|
|
282
285
|
|
|
283
286
|
|
|
284
287
|
| Entry point | Use |
|
|
285
288
|
| --- | --- |
|
|
286
|
-
| `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
287
|
-
| `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
289
|
+
| `/statusline-configure-native` | Client TUI in the current session; see [native editor](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#native-configuration-editor) |
|
|
290
|
+
| `/statusline-configure` | TUI in a supported external terminal; see [external entry](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#external-terminal-statusline-configure) |
|
|
288
291
|
| `claude-statusline configure` | Full TUI in the current standalone terminal |
|
|
289
292
|
| `/statusline-config` | Claude question-and-answer wizard; supported argument-based commands execute locally on compatible hosts |
|
|
290
293
|
| `claude-statusline config ...` | Inspect settings, set exact ordering, or configure from scripts |
|
|
@@ -302,7 +305,7 @@ claude-statusline config language reset
|
|
|
302
305
|
claude-statusline --language en --help
|
|
303
306
|
```
|
|
304
307
|
|
|
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.
|
|
308
|
+
`--language en|zh-CN|zh-TW|zh-HK|ja|ko` precedes the command and affects only that invocation; for `configure` it sets the initial language. Commands, IDs, configuration values and custom text retain their values. Interface language does not change output language. See [language settings](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#interface-language).
|
|
306
309
|
|
|
307
310
|
### Statusline language
|
|
308
311
|
|
|
@@ -313,13 +316,13 @@ claude-statusline config set statusline-language zh-TW
|
|
|
313
316
|
claude-statusline config set statusline-language en
|
|
314
317
|
```
|
|
315
318
|
|
|
316
|
-

|
|
317
320
|
|
|
318
|
-

|
|
319
322
|
|
|
320
|
-
These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
323
|
+
These are [real CLI terminal captures with fixed input](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/images/README.md#statusline-language-captures).
|
|
321
324
|
|
|
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.
|
|
325
|
+
Built-in labels and known states are translated. Technical units, model names, branches, paths and custom text are preserved. See [output language](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#statusline-language).
|
|
323
326
|
|
|
324
327
|
### Native configuration editor
|
|
325
328
|
|
|
@@ -339,7 +342,7 @@ claude-statusline config set directory-style home
|
|
|
339
342
|
claude-statusline config show
|
|
340
343
|
```
|
|
341
344
|
|
|
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.
|
|
345
|
+
Configuration is per user. `set-items` replaces the enabled set; `enable` and `disable` make incremental changes. See [recipes](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#configuration-recipes), [formatting and layouts](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#formatting-layout-presets), and the [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/reference/cli.md).
|
|
343
346
|
|
|
344
347
|
<a id="upgrade-to-v161"></a>
|
|
345
348
|
|
|
@@ -353,7 +356,7 @@ claude-statusline install
|
|
|
353
356
|
claude-statusline doctor
|
|
354
357
|
```
|
|
355
358
|
|
|
356
|
-
Existing Python installations should first follow the [migration and rollback procedure](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
359
|
+
Existing Python installations should first follow the [migration and rollback procedure](https://github.com/fbincon/claude-code-statusline/blob/v3.5.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.5.0/docs/USER_GUIDE.md#version-compatibility).
|
|
357
360
|
|
|
358
361
|
Remove Claude integration before uninstalling the package:
|
|
359
362
|
|
|
@@ -363,7 +366,7 @@ claude-statusline uninstall
|
|
|
363
366
|
npm uninstall --global @fbincon/claude-code-statusline
|
|
364
367
|
```
|
|
365
368
|
|
|
366
|
-
Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
369
|
+
Display settings and backups remain available; see [uninstalling](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md#uninstalling).
|
|
367
370
|
|
|
368
371
|
## Project structure
|
|
369
372
|
|
|
@@ -399,6 +402,7 @@ claude-code-statusline/
|
|
|
399
402
|
│ ├── typescript/ # Runtime constraints and test entry points
|
|
400
403
|
│ └── unicode/ # Pinned data, provenance and licenses
|
|
401
404
|
├── archive/python/ # Frozen Python implementation, tests, tools and publishing workflows
|
|
405
|
+
├── examples/schemes/ # Shareable built-in complete schemes
|
|
402
406
|
├── docs/ # Usage, development, migration and historical releases
|
|
403
407
|
│ ├── reference/ # CLI and configuration reference
|
|
404
408
|
│ ├── development/ # Architecture, testing and stage records
|
|
@@ -413,15 +417,16 @@ claude-code-statusline/
|
|
|
413
417
|
|
|
414
418
|
## Documentation and help
|
|
415
419
|
|
|
416
|
-
- [
|
|
417
|
-
- [
|
|
418
|
-
- [
|
|
419
|
-
- [
|
|
420
|
-
- [
|
|
420
|
+
- [First-use setup](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/SETUP.md) · [Three complete schemes](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/SCHEMES.md) · [Appearance controls](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/APPEARANCE.md).
|
|
421
|
+
- [User guide](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/USER_GUIDE.md): installation, editors, recipes, upgrades, and troubleshooting.
|
|
422
|
+
- [CLI reference](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/reference/cli.md): commands, options, fields, files, and exit codes.
|
|
423
|
+
- [Display items and metric definitions](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/DISPLAY_ITEMS.md): scope, sources, and availability.
|
|
424
|
+
- [Development guide](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/development/README.md) · [Release process](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/docs/RELEASING.md).
|
|
425
|
+
- [Changelog](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/CHANGELOG.md) · [GitHub Releases](https://github.com/fbincon/claude-code-statusline/releases).
|
|
421
426
|
- [GitHub Issues](https://github.com/fbincon/claude-code-statusline/issues): include versions, reproduction steps, and diagnostic results; remove private paths and session content.
|
|
422
427
|
|
|
423
428
|
## License
|
|
424
429
|
|
|
425
|
-
[MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
430
|
+
[MIT License](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/LICENSE). Copyright (c) 2026 [fbincon](https://github.com/fbincon).
|
|
426
431
|
|
|
427
|
-
Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.
|
|
432
|
+
Bundled Unicode data retains the [Unicode License v3](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/tools/unicode/UNICODE-LICENSE.txt) and the [wcwidth MIT notice](https://github.com/fbincon/claude-code-statusline/blob/v3.5.0/tools/unicode/WCWIDTH-LICENSE.txt).
|