@alyibrahim/claude-statusline 1.1.0 → 1.1.1
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 +60 -26
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,12 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://github.com/AlyIbrahim1/claude-statusline/actions/workflows/ci.yml)
|
|
4
4
|
[](https://www.npmjs.com/package/@alyibrahim/claude-statusline)
|
|
5
|
+
[](https://www.npmjs.com/package/@alyibrahim/claude-statusline)
|
|
6
|
+
[](LICENSE)
|
|
5
7
|
|
|
6
|
-
A fast statusline for [Claude Code](https://claude.ai/code)
|
|
8
|
+
**A rich, fast statusline for [Claude Code](https://claude.ai/code)** — shows model, git branch, context usage, rate limits, and session cost after every response.
|
|
7
9
|
|
|
8
|
-
Runs as a compiled Rust binary
|
|
10
|
+
Runs as a **compiled Rust binary** (~5ms startup vs ~100ms for Node.js). Zero shell dependencies. One install command.
|
|
9
11
|
|
|
10
|
-
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
---
|
|
11
15
|
|
|
12
16
|
## Install
|
|
13
17
|
|
|
@@ -15,36 +19,64 @@ Runs as a compiled Rust binary on Linux x64/arm64, macOS x64/arm64, and Windows
|
|
|
15
19
|
npm install -g @alyibrahim/claude-statusline
|
|
16
20
|
```
|
|
17
21
|
|
|
18
|
-
|
|
22
|
+
Done. The statusline configures itself automatically. Restart Claude Code to see it.
|
|
19
23
|
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
claude-statusline setup
|
|
23
|
-
```
|
|
24
|
+
> If auto-setup didn't run: `claude-statusline setup`
|
|
24
25
|
|
|
25
|
-
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## What you get
|
|
29
|
+
|
|
30
|
+
**Line 1** — Model name · Effort level · Active subagents · Current task · Directory `[branch]` · Context bar
|
|
31
|
+
|
|
32
|
+
**Line 2** — Weekly token usage · 5h usage · Reset countdown *(Pro/Max)* — or — Session cost *(API key)*
|
|
33
|
+
|
|
34
|
+
| Feature | Details |
|
|
35
|
+
|---|---|
|
|
36
|
+
| Context bar | Normalized to usable % — accounts for the auto-compact buffer |
|
|
37
|
+
| Rate limits | Shows 5h and weekly usage with color-coded thresholds |
|
|
38
|
+
| Session cost | Displayed only for API key users, hidden for subscribers |
|
|
39
|
+
| Active agents | Counts running subagents from your `~/.claude/todos/` directory |
|
|
40
|
+
| Effort level | Reads `CLAUDE_CODE_EFFORT_LEVEL` env var or `settings.json` |
|
|
41
|
+
| Git branch | Detected automatically, silently absent if not a git repo |
|
|
26
42
|
|
|
27
|
-
|
|
28
|
-
- **git** — optional, used for branch display; gracefully absent if not installed
|
|
43
|
+
---
|
|
29
44
|
|
|
30
|
-
|
|
45
|
+
## Platform support
|
|
31
46
|
|
|
32
|
-
|
|
47
|
+
The Rust binary is pre-built and installed automatically for your platform via npm `optionalDependencies`:
|
|
33
48
|
|
|
34
|
-
|
|
49
|
+
| Platform | Package |
|
|
50
|
+
|---|---|
|
|
51
|
+
| Linux x64 | [`@alyibrahim/claude-statusline-linux-x64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-linux-x64) |
|
|
52
|
+
| Linux arm64 | [`@alyibrahim/claude-statusline-linux-arm64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-linux-arm64) |
|
|
53
|
+
| macOS x64 (Intel) | [`@alyibrahim/claude-statusline-darwin-x64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-darwin-x64) |
|
|
54
|
+
| macOS arm64 (Apple Silicon) | [`@alyibrahim/claude-statusline-darwin-arm64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-darwin-arm64) |
|
|
55
|
+
| Windows x64 | [`@alyibrahim/claude-statusline-win32-x64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-win32-x64) |
|
|
35
56
|
|
|
36
|
-
|
|
57
|
+
npm picks the right one automatically. If your platform isn't listed, the JS fallback is used instead — no action needed.
|
|
58
|
+
|
|
59
|
+
---
|
|
37
60
|
|
|
38
61
|
## Why this one
|
|
39
62
|
|
|
40
|
-
| |
|
|
63
|
+
| | claude-statusline | Others |
|
|
41
64
|
|---|---|---|
|
|
42
|
-
|
|
|
43
|
-
|
|
|
44
|
-
|
|
|
45
|
-
| Subscription
|
|
46
|
-
| Context bar
|
|
47
|
-
|
|
|
65
|
+
| Startup time | ~5ms (Rust binary) | ~100ms (Node.js cold-start every prompt) |
|
|
66
|
+
| Shell dependencies | None | Require `jq`, `bc`, or `ccusage` |
|
|
67
|
+
| API calls | None — reads Claude's stdin directly | Poll OAuth endpoint, risk rate limits |
|
|
68
|
+
| Subscription-aware | Shows usage/resets for Pro/Max, cost for API | Treat everyone as API user |
|
|
69
|
+
| Context bar | Usable % after auto-compact buffer | Raw remaining % |
|
|
70
|
+
| Subagent counter | Counts active agents from todos dir | — |
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## Requirements
|
|
75
|
+
|
|
76
|
+
- **Node.js ≥16** — for install/uninstall scripts only (not needed at runtime on supported platforms)
|
|
77
|
+
- **git** — optional, enables branch display
|
|
78
|
+
|
|
79
|
+
---
|
|
48
80
|
|
|
49
81
|
## Uninstall
|
|
50
82
|
|
|
@@ -53,13 +85,15 @@ claude-statusline uninstall
|
|
|
53
85
|
npm uninstall -g @alyibrahim/claude-statusline
|
|
54
86
|
```
|
|
55
87
|
|
|
56
|
-
>
|
|
88
|
+
> Always run `claude-statusline uninstall` first — it removes the `statusLine` entry from `~/.claude/settings.json` before the files are deleted.
|
|
89
|
+
|
|
90
|
+
---
|
|
57
91
|
|
|
58
92
|
## Notes
|
|
59
93
|
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
-
|
|
94
|
+
- Settings are written only to the `statusLine` key — all other `~/.claude/settings.json` keys are untouched
|
|
95
|
+
- Respects `$CLAUDE_CONFIG_DIR` if set
|
|
96
|
+
- Switched Node versions on an unsupported platform? Re-run `claude-statusline setup`
|
|
63
97
|
|
|
64
98
|
## License
|
|
65
99
|
|