mochiapi-statusline 0.1.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/LICENSE +21 -0
- package/README.md +386 -0
- package/dist/ccstatusline.js +75122 -0
- package/package.json +74 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Matthew Breedlove (https://github.com/sirmalloc)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,386 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<pre>
|
|
4
|
+
_ _ _ _
|
|
5
|
+
___ ___ ___| |_ __ _| |_ _ _ ___| (_)_ __ ___
|
|
6
|
+
/ __/ __/ __| __/ _` | __| | | / __| | | '_ \ / _ \
|
|
7
|
+
| (_| (__\__ \ || (_| | |_| |_| \__ \ | | | | | __/
|
|
8
|
+
\___\___|___/\__\__,_|\__|\__,_|___/_|_|_| |_|\___|
|
|
9
|
+
|
|
10
|
+
</pre>
|
|
11
|
+
|
|
12
|
+
# ccstatusline
|
|
13
|
+
|
|
14
|
+
**๐จ A highly customizable status line formatter for Claude Code CLI**
|
|
15
|
+
*Display model info, git branch, token usage, and other metrics in your terminal*
|
|
16
|
+
|
|
17
|
+
[](https://www.npmjs.com/package/ccstatusline)
|
|
18
|
+
[](https://www.npmjs.com/package/ccstatusline)
|
|
19
|
+
[](https://github.com/sirmalloc/ccstatusline/blob/main/LICENSE)
|
|
20
|
+
[](https://nodejs.org)
|
|
21
|
+
[](https://packagephobia.com/result?p=ccstatusline)
|
|
22
|
+
[](https://github.com/sirmalloc/ccstatusline/graphs/commit-activity)
|
|
23
|
+
|
|
24
|
+
[](https://github.com/hesreallyhim/awesome-claude-code)
|
|
25
|
+
[](https://claudelog.com/)
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
</div>
|
|
31
|
+
<br />
|
|
32
|
+
|
|
33
|
+
> [!IMPORTANT]
|
|
34
|
+
> **This is the `mochiapi-statusline` fork** โ a customized build of upstream [sirmalloc/ccstatusline](https://github.com/sirmalloc/ccstatusline) with a built-in **MochiAPI balance widget** plus a one-shot setup that wires Claude Code and the recommended Mochi three-line layout for you.
|
|
35
|
+
>
|
|
36
|
+
> **If you came here to use this fork, follow [MOCHIAPI.md](MOCHIAPI.md) โ not the upstream instructions below.** The two commands you need:
|
|
37
|
+
>
|
|
38
|
+
> ```bash
|
|
39
|
+
> npm install -g github:Subaru486desuwa/mochiapi-statusline
|
|
40
|
+
> mochiapi-statusline --mochiapi-setup
|
|
41
|
+
> ```
|
|
42
|
+
>
|
|
43
|
+
> The rest of this README is upstream documentation and applies as-is to the underlying ccstatusline engine (widgets, TUI, themes, etc.) โ keep reading if you want to customize beyond the defaults.
|
|
44
|
+
|
|
45
|
+
<br />
|
|
46
|
+
|
|
47
|
+
## ๐ Table of Contents
|
|
48
|
+
|
|
49
|
+
- [Recent Updates](#-recent-updates)
|
|
50
|
+
- [Features](#-features)
|
|
51
|
+
- [Localizations](#-localizations)
|
|
52
|
+
- [Quick Start](#-quick-start)
|
|
53
|
+
- [Windows Support](docs/WINDOWS.md)
|
|
54
|
+
- [Usage](docs/USAGE.md)
|
|
55
|
+
- [Development](docs/DEVELOPMENT.md)
|
|
56
|
+
- [Contributing](#-contributing)
|
|
57
|
+
- [License](#-license)
|
|
58
|
+
- [Related Projects](#-related-projects)
|
|
59
|
+
|
|
60
|
+
<br />
|
|
61
|
+
|
|
62
|
+
## ๐ Recent Updates
|
|
63
|
+
|
|
64
|
+
### v2.2.13 - Weekly model usage, voice status, hooks, and docs
|
|
65
|
+
|
|
66
|
+
- **๐ Weekly Sonnet/Opus usage widgets** - Added separate weekly usage widgets for Sonnet and Opus API buckets, matching Claude Code's `/usage` model split.
|
|
67
|
+
- **๐ค Voice Status widget** - Added a widget that shows whether Claude Code voice input is enabled, with icon, text, word, and optional Nerd Font display modes.
|
|
68
|
+
- **๐ Timer short bars** - Block Timer, Block Reset Timer, and Weekly Reset Timer now support compact short-bar progress displays.
|
|
69
|
+
- **๐ Quieter hook output** - Hook handling now suppresses no-op JSON output so non-status updates stay silent.
|
|
70
|
+
|
|
71
|
+
### v2.2.9 - v2.2.12 - GitLab support, reset timers, context, compaction, and git widgets
|
|
72
|
+
|
|
73
|
+
- **๐ฆ GitLab PR/MR support** - `Git Branch` and `Git PR/MR` now support GitHub, GitLab, and compatible self-hosted remotes, using `gh` or `glab` as appropriate.
|
|
74
|
+
- **๐ Status line refresh interval** - Installed configs can set Claude Code's `statusLine.refreshInterval` from the TUI when Claude Code >=2.1.97 supports it.
|
|
75
|
+
- **๐งญ Wrap-around TUI navigation** - Menu/list navigation and move/reorder modes now wrap at the first and last items.
|
|
76
|
+
- **๐ Clone widget shortcut** - Press `k` in the item editor to duplicate the selected widget, with fresh Powerline background color for cloned Powerline items.
|
|
77
|
+
- **๐ Short bar display modes** - Context percentage, Context Bar, Session Usage, Weekly Usage, Block Timer, and reset timer widgets can use compact bar variants.
|
|
78
|
+
- **โฑ๏ธ Usage time cursor** - Session Usage and Weekly Usage progress bars can show the elapsed time position within the current usage window.
|
|
79
|
+
- **๐ Reset timer timestamps** - Block and Weekly Reset Timer widgets can show exact reset timestamps with compact formatting, 12/24-hour display, IANA time zones, and locale selection.
|
|
80
|
+
- **๐ช Context Window widget** - Added a `Context Window` widget for total model window size, keeping `Context Length` focused on current context usage.
|
|
81
|
+
- **๐ Compaction Counter widget** - Added a `Compaction Counter` widget that tracks session context compactions, with icon/text/number formats, optional Nerd Font icon, and hide-when-zero behavior.
|
|
82
|
+
- **๐งฎ Git file status widgets** - Added `Git Staged Files`, `Git Unstaged Files`, `Git Untracked Files`, and `Git Clean Status` for file counts and clean/dirty state.
|
|
83
|
+
- **๐ท๏ธ Clear context percentage labels** - `Context %` and `Context % (usable)` now label rendered values as used or left when toggling used/remaining mode.
|
|
84
|
+
- **โก More Powerline caps** - The Powerline separator editor now supports more than three start/end caps.
|
|
85
|
+
- **๐ง Thinking Effort updates** - Added `xhigh`, show `default` when no effort is set, mark unknown future effort levels with `?`, and track live status JSON plus `/effort` command changes.
|
|
86
|
+
- **๐งฎ More accurate token counts** - Streaming duplicate JSONL entries are deduped so token widgets do not overcount live Claude Code output.
|
|
87
|
+
- **๐ท๏ธ Cleaner model display** - The Model widget strips trailing context suffixes like `(1M context)`; use `Context Window` when you want the total window size shown.
|
|
88
|
+
- **๐งน Cleaner empty-widget separators** - Manual separators now collapse around widgets that render empty, avoiding dangling separators when hide-when-empty widgets disappear.
|
|
89
|
+
- **๐งฑ More resilient Git helpers** - Git widgets handle missing or unusual git command output more defensively.
|
|
90
|
+
|
|
91
|
+
### v2.2.8 - Git widgets, smarter picker search, and minimalist mode
|
|
92
|
+
|
|
93
|
+
- **๐ New Git PR widget** - Added a `Git PR` widget with clickable PR links plus optional status and title display for the current branch.
|
|
94
|
+
- **๐งฐ Major Git widget expansion** - Added `Git Status`, `Git Staged`, `Git Unstaged`, `Git Untracked`, `Git Ahead/Behind`, `Git Conflicts`, `Git SHA`, `Git Origin Owner`, `Git Origin Repo`, `Git Origin Owner/Repo`, `Git Upstream Owner`, `Git Upstream Repo`, `Git Upstream Owner/Repo`, `Git Is Fork`, `Git Worktree Mode`, `Git Worktree Name`, `Git Worktree Branch`, `Git Worktree Original Branch`, and `Custom Symbol`.
|
|
95
|
+
- **๐ค Claude Account Email widget** - Added a session widget that reads the signed-in Claude account email from `~/.claude.json` while respecting `CLAUDE_CONFIG_DIR`.
|
|
96
|
+
- **๐งผ Global Minimalist Mode** - Added a global toggle in `Global Overrides` that forces widgets into raw-value mode for a cleaner, label-free status line.
|
|
97
|
+
- **๐ Smarter widget picker search** - The add/change widget picker now supports substring, initialism, and fuzzy matching, with ranked results and live match highlighting.
|
|
98
|
+
- **๐ Better terminal width detection** - Flex separators and right-alignment now work more reliably when ccstatusline is launched through wrapper processes or nested PTYs.
|
|
99
|
+
- **๐จ Powerline theme continuity** - Built-in Powerline themes can now continue colors cleanly across multiple status lines instead of restarting each line.
|
|
100
|
+
|
|
101
|
+
### v2.2.0 - v2.2.6 - Speed, widgets, links, and reliability updates
|
|
102
|
+
|
|
103
|
+
- **๐ New Token Speed widgets** - Added three widgets: **Input Speed**, **Output Speed**, and **Total Speed**.
|
|
104
|
+
- Each speed widget supports a configurable window of `0-120` seconds in the widget editor (`w` key).
|
|
105
|
+
- `0` disables window mode and uses a full-session average speed.
|
|
106
|
+
- `1-120` calculates recent speed over the selected rolling window.
|
|
107
|
+
- **๐งฉ New Skills widget controls (v2.2.1)** - Added configurable Skills modes (last/count/list), optional hide-when-empty behavior, and list-size limiting with most-recent-first ordering.
|
|
108
|
+
- **๐ Usage API proxy support (v2.2.2)** - Usage widgets honor the uppercase `HTTPS_PROXY` environment variable for their direct API call to Anthropic.
|
|
109
|
+
- **๐ง New Thinking Effort widget (v2.2.4)** - Added a widget that shows the current Claude Code thinking effort level.
|
|
110
|
+
- **๐ Better macOS usage lookup reliability (v2.2.5)** - Improved reliability when loading usage API tokens on macOS.
|
|
111
|
+
- **โจ๏ธ New Vim Mode widget (v2.2.5)** - Added a widget that shows the current vim mode, with ASCII and optional Nerd Font icon display.
|
|
112
|
+
- **๐ Git widget link modes (v2.2.6)** - `Git Branch` can render clickable GitHub branch links, and `Git Root Dir` can render clickable IDE links for VS Code and Cursor.
|
|
113
|
+
- **๐ค Better subagent-aware speed reporting** - Token speed calculations continue to include referenced subagent activity so displayed speeds better reflect actual concurrent work.
|
|
114
|
+
|
|
115
|
+
<br />
|
|
116
|
+
<details>
|
|
117
|
+
<summary><b>Older updates (v2.1.10 and earlier)</b></summary>
|
|
118
|
+
|
|
119
|
+
### v2.1.0 - v2.1.10 - Usage widgets, links, new git insertions / deletions widgets, and reliability fixes
|
|
120
|
+
|
|
121
|
+
- **๐งฉ New Usage widgets (v2.1.0)** - Added **Session Usage**, **Weekly Usage**, **Block Reset Timer**, and **Context Bar** widgets.
|
|
122
|
+
- **๐ More accurate counts (v2.1.0)** - Usage/context widgets now use new statusline JSON metrics when available for more accurate token and context counts.
|
|
123
|
+
- **๐ช Windows empty file bug fix (v2.1.1)** - Fixed a Windows issue that could create an empty `c:\dev\null` file.
|
|
124
|
+
- **๐ New Link widget (v2.1.3)** - Added a new **Link** widget with clickable OSC8 rendering, preview parity, and raw mode support.
|
|
125
|
+
- **โ New Git Insertions widget (v2.1.4)** - Added a dedicated Git widget that shows only uncommitted insertions (e.g., `+42`).
|
|
126
|
+
- **โ New Git Deletions widget (v2.1.4)** - Added a dedicated Git widget that shows only uncommitted deletions (e.g., `-10`).
|
|
127
|
+
- **๐ง Context format fallback fix (v2.1.6)** - When `context_window_size` is missing, context widgets now infer 1M models from long-context labels such as `[1m]` and `1M context` in model identifiers.
|
|
128
|
+
- **โณ Weekly reset timer split (v2.1.7)** - Added a separate `Weekly Reset Timer` widget.
|
|
129
|
+
- **โ๏ธ Custom config file flag (v2.1.8)** - Added `--config <path>` support so ccstatusline can load/save settings from a custom file location.
|
|
130
|
+
- **๐ฃ Unicode separator hex input upgrade (v2.1.9)** - Powerline separator hex input now supports 4-6 digits (full Unicode code points up to `U+10FFFF`).
|
|
131
|
+
- **๐ณ Bare repo worktree detection fix (v2.1.10)** - `Git Worktree` now correctly detects linked worktrees created from bare repositories.
|
|
132
|
+
|
|
133
|
+
### v2.0.26 - v2.0.29 - Performance, git internals, and workflow improvements
|
|
134
|
+
|
|
135
|
+
- **๐ง Memory Usage widget (v2.0.29)** - Added a new widget that shows current system memory usage (`Mem: used/total`).
|
|
136
|
+
- **โก Block timer cache (v2.0.28)** - Cache block timer metrics to reduce JSONL parsing on every render, with per-config hashed cache files and automatic 5-hour block invalidation.
|
|
137
|
+
- **๐งฑ Git widget command refactor (v2.0.28)** - Refactored git widgets to use shared git command helpers and expanded coverage for failure and edge-case tests.
|
|
138
|
+
- **๐ช Windows UTF-8 piped output fix (v2.0.28)** - Sets the Windows UTF-8 code page for piped status line rendering.
|
|
139
|
+
- **๐ Git Root Dir widget (v2.0.27)** - Added a new Git widget that shows the repository root directory name.
|
|
140
|
+
- **๐ท๏ธ Session Name widget (v2.0.26)** - Added a new widget that shows the current Claude Code session name from `/rename`.
|
|
141
|
+
- **๐ Current Working Directory home abbreviation (v2.0.26)** - Added a `~` abbreviation option for CWD display in both preview and live rendering.
|
|
142
|
+
- **๐ง Context model suffix fix (v2.0.26)** - Context widgets now recognize the `[1m]` suffix across models, not just a single model path.
|
|
143
|
+
- **๐งญ Widget picker UX updates (v2.0.26)** - Improved widget discovery/navigation and added clearer, safer clear-line behavior.
|
|
144
|
+
- **โจ๏ธ TUI editor input fix (v2.0.26)** - Prevented shortcut/input leakage into widget editor flows.
|
|
145
|
+
- **๐ Repo docs update (v2.0.26)** - Migrated guidance from `CLAUDE.md` to `AGENTS.md` (with symlink compatibility).
|
|
146
|
+
|
|
147
|
+
### v2.0.16 - Add fish style path abbreviation toggle to Current Working Directory widget
|
|
148
|
+
|
|
149
|
+
### v2.0.15 - Block Timer calculation fixes
|
|
150
|
+
|
|
151
|
+
- Fix miscalculation in the block timer
|
|
152
|
+
|
|
153
|
+
### v2.0.14 - Add remaining mode toggle to Context Percentage widgets
|
|
154
|
+
|
|
155
|
+
- **Remaining Mode** - You can now toggle the Context Percentage widgets between usage percentage and remaining percentage when configuring them in the TUI by pressing the 'u' key.
|
|
156
|
+
|
|
157
|
+
### v2.0.12 - Custom Text widget now supports emojis
|
|
158
|
+
|
|
159
|
+
- **๐พ Emoji Support** - You can now paste emoji into the custom text widget. You can also turn on the merge option to get emoji labels for your widgets like this:
|
|
160
|
+
|
|
161
|
+
|
|
162
|
+
|
|
163
|
+
### v2.0.11 - Unlimited Status Lines
|
|
164
|
+
|
|
165
|
+
- **๐ No Line Limit** - Configure as many status lines as you need - the 3-line limitation has been removed
|
|
166
|
+
|
|
167
|
+
### v2.0.10 - Git Updates
|
|
168
|
+
|
|
169
|
+
- **๐ณ Git Worktree widget** - Shows the active worktree name when working with git worktrees
|
|
170
|
+
- **๐ป Hide 'no git' message toggle** - Git widgets now support hiding the 'no git' message when not in a repository (toggle with 'h' key while editing the widget)
|
|
171
|
+
|
|
172
|
+
### v2.0.8 - Powerline Auto-Alignment
|
|
173
|
+
|
|
174
|
+
|
|
175
|
+
|
|
176
|
+
- **๐ฏ Widget Alignment** - Auto-align widgets across multiple status lines in Powerline mode for a clean, columnar layout (toggle with 'a' in Powerline Setup)
|
|
177
|
+
|
|
178
|
+
### v2.0.7 - Current Working Directory & Session Cost
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
|
|
182
|
+
- **๐ Current Working Directory** - Display the current working directory with configurable segment display
|
|
183
|
+
- Set the number of path segments to show (e.g., show only last 2 segments: `.../Personal/ccstatusline`)
|
|
184
|
+
- Supports raw value mode for compact display
|
|
185
|
+
- Automatically truncates long paths with ellipsis
|
|
186
|
+
- **๐ฐ Session Cost Widget** - Track your Claude Code session costs (requires Claude Code 1.0.85+)
|
|
187
|
+
- Displays total session cost in USD
|
|
188
|
+
- Supports raw value mode (shows just `$X.YZ` vs `Cost: $X.YZ`)
|
|
189
|
+
- Real-time cost tracking from Claude Code session data
|
|
190
|
+
- Note: Cost may not update properly when using `/resume` (Claude Code limitation)
|
|
191
|
+
- **๐ Bug Fixes**
|
|
192
|
+
- Fixed Block Timer calculations for accurate time tracking across block boundaries
|
|
193
|
+
- Improved widget editor stability with proper Ctrl+S handling
|
|
194
|
+
- Enhanced cursor display in numeric input fields
|
|
195
|
+
|
|
196
|
+
### v2.0.2 - Block Timer Widget
|
|
197
|
+
|
|
198
|
+
|
|
199
|
+
|
|
200
|
+
- **โฑ๏ธ Block Timer** - Track your progress through 5-hour Claude Code blocks
|
|
201
|
+
- Displays time elapsed in current block as hours/minutes (e.g., "3hr 45m")
|
|
202
|
+
- Progress bar mode shows visual completion percentage
|
|
203
|
+
- Two progress bar styles: full width (32 chars) or compact (16 chars)
|
|
204
|
+
- Automatically detects block boundaries from transcript timestamps
|
|
205
|
+
|
|
206
|
+
### v2.0.0 - Powerline Support & Enhanced Themes
|
|
207
|
+
- **โก Powerline Mode** - Beautiful Powerline-style status lines with arrow separators and customizable caps
|
|
208
|
+
- **๐จ Built-in Themes** - Multiple pre-configured themes that you can copy and customize
|
|
209
|
+
- **๐ Advanced Color Support** - Basic (16), 256-color (with custom ANSI codes), and truecolor (with hex codes) modes
|
|
210
|
+
- **๐ Widget Merging** - Merge multiple widgets together with or without padding for seamless designs
|
|
211
|
+
- **๐ฆ Easy Installation** - Install directly with `npx` or `bunx` - no global package needed
|
|
212
|
+
- **๐ค Custom Separators** - Add multiple Powerline separators with custom hex codes for font support
|
|
213
|
+
- **๐ Auto Font Install** - Automatic Powerline font installation with user consent
|
|
214
|
+
|
|
215
|
+
</details>
|
|
216
|
+
|
|
217
|
+
<br />
|
|
218
|
+
|
|
219
|
+
## โจ Features
|
|
220
|
+
|
|
221
|
+
- **๐ Real-time Metrics** - Display model name, git branch, token usage, per-model weekly usage, voice input state, session duration, compaction count, block timer, and more
|
|
222
|
+
- **๐จ Fully Customizable** - Choose what to display and customize colors for each element
|
|
223
|
+
- **โก Powerline Support** - Beautiful Powerline-style rendering with arrow separators, caps, and custom fonts
|
|
224
|
+
- **๐ Multi-line Support** - Configure multiple independent status lines
|
|
225
|
+
- **๐ฅ๏ธ Interactive TUI** - Built-in configuration interface using React/Ink
|
|
226
|
+
- **๐ Fast Widget Picker** - Add/change widgets by category with search and ranked matching
|
|
227
|
+
- **โ๏ธ Global Options** - Apply consistent formatting across all widgets (padding, separators, bold, minimalist mode, and color overrides)
|
|
228
|
+
- **๐ Cross-platform** - Works seamlessly with both Bun and Node.js
|
|
229
|
+
- **๐ง Flexible Configuration** - Supports custom Claude Code config directory via `CLAUDE_CONFIG_DIR` environment variable
|
|
230
|
+
- **๐ Smart Width Detection** - Automatically adapts to terminal width with flex separators
|
|
231
|
+
- **โก Zero Config** - Sensible defaults that work out of the box
|
|
232
|
+
|
|
233
|
+
<br />
|
|
234
|
+
|
|
235
|
+
## ๐ Localizations
|
|
236
|
+
|
|
237
|
+
The localizations in this section are third-party forks maintained outside this repository. They are not maintained, reviewed, or endorsed by this repository, so review their code and releases before using them.
|
|
238
|
+
|
|
239
|
+
- ๐ **ไธญๆ็ (Chinese):** [ccstatusline-zh](https://github.com/huangguang1999/ccstatusline-zh)
|
|
240
|
+
|
|
241
|
+
<br />
|
|
242
|
+
|
|
243
|
+
## ๐ Quick Start
|
|
244
|
+
|
|
245
|
+
### No installation needed! Use directly with npx or bunx:
|
|
246
|
+
|
|
247
|
+
```bash
|
|
248
|
+
# Run the configuration TUI with npm
|
|
249
|
+
npx -y ccstatusline@latest
|
|
250
|
+
|
|
251
|
+
# Or with Bun (faster)
|
|
252
|
+
bunx -y ccstatusline@latest
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
<br />
|
|
256
|
+
<details>
|
|
257
|
+
<summary><b>Configure ccstatusline</b></summary>
|
|
258
|
+
|
|
259
|
+
The interactive configuration tool provides a terminal UI where you can:
|
|
260
|
+
- Configure multiple separate status lines
|
|
261
|
+
- Add/remove/reorder status line widgets
|
|
262
|
+
- Customize colors for each widget
|
|
263
|
+
- Configure flex separator behavior
|
|
264
|
+
- Configure Claude Code status line refresh interval when supported
|
|
265
|
+
- Edit custom text widgets
|
|
266
|
+
- Install/uninstall to Claude Code settings
|
|
267
|
+
- Preview your status line in real-time
|
|
268
|
+
|
|
269
|
+
> ๐ก **Tip:** Your settings are automatically saved to `~/.config/ccstatusline/settings.json`
|
|
270
|
+
|
|
271
|
+
> ๐ง **Custom Claude Config:** If your Claude Code configuration is in a non-standard location, set the `CLAUDE_CONFIG_DIR` environment variable:
|
|
272
|
+
> ```bash
|
|
273
|
+
> # Linux/macOS
|
|
274
|
+
> export CLAUDE_CONFIG_DIR=/custom/path/to/.claude
|
|
275
|
+
> ```
|
|
276
|
+
|
|
277
|
+
> ๐ **Usage API proxy:** Usage widgets honor the uppercase `HTTPS_PROXY` environment variable for their direct API call to Anthropic.
|
|
278
|
+
|
|
279
|
+
> ๐ช **Windows Support:** PowerShell examples, installation notes, fonts, troubleshooting, WSL, and Windows Terminal configuration are in [docs/WINDOWS.md](docs/WINDOWS.md).
|
|
280
|
+
|
|
281
|
+
</details>
|
|
282
|
+
|
|
283
|
+
<details>
|
|
284
|
+
<summary><b>Claude Code settings.json format</b></summary>
|
|
285
|
+
|
|
286
|
+
When you install from the TUI, ccstatusline writes a `statusLine` command object to your Claude Code settings:
|
|
287
|
+
|
|
288
|
+
```json
|
|
289
|
+
{
|
|
290
|
+
"statusLine": {
|
|
291
|
+
"type": "command",
|
|
292
|
+
"command": "npx -y ccstatusline@latest",
|
|
293
|
+
"padding": 0,
|
|
294
|
+
"refreshInterval": 10
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
```
|
|
298
|
+
|
|
299
|
+
`refreshInterval` is written only when your Claude Code version supports it (>=2.1.97). The TUI can set it to `1-60` seconds, or remove it by leaving the input empty.
|
|
300
|
+
|
|
301
|
+
Other supported command values are:
|
|
302
|
+
- `bunx -y ccstatusline@latest`
|
|
303
|
+
- `ccstatusline` (for self-managed/global installs)
|
|
304
|
+
|
|
305
|
+
</details>
|
|
306
|
+
|
|
307
|
+
## ๐ค Contributing
|
|
308
|
+
|
|
309
|
+
Contributions are welcome! Please feel free to submit a Pull Request.
|
|
310
|
+
|
|
311
|
+
1. Fork the repository
|
|
312
|
+
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
|
|
313
|
+
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
|
|
314
|
+
4. Push to the branch (`git push origin feature/amazing-feature`)
|
|
315
|
+
5. Open a Pull Request
|
|
316
|
+
|
|
317
|
+
|
|
318
|
+
## Support
|
|
319
|
+
|
|
320
|
+
If ccstatusline is useful to you, consider buying me a coffee:
|
|
321
|
+
|
|
322
|
+
<a href="https://www.buymeacoffee.com/sirmalloc" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
|
|
323
|
+
|
|
324
|
+
|
|
325
|
+
## ๐ License
|
|
326
|
+
|
|
327
|
+
[MIT](LICENSE) ยฉ Matthew Breedlove
|
|
328
|
+
|
|
329
|
+
|
|
330
|
+
## ๐ค Author
|
|
331
|
+
|
|
332
|
+
**Matthew Breedlove**
|
|
333
|
+
|
|
334
|
+
- GitHub: [@sirmalloc](https://github.com/sirmalloc)
|
|
335
|
+
|
|
336
|
+
|
|
337
|
+
## ๐ Related Projects
|
|
338
|
+
|
|
339
|
+
- [tweakcc](https://github.com/Piebald-AI/tweakcc) - Customize Claude Code themes, thinking verbs, and more.
|
|
340
|
+
- [ccusage](https://github.com/ryoppippi/ccusage) - Track and display Claude Code usage metrics.
|
|
341
|
+
- [codachi](https://github.com/vincent-k2026/codachi) - A tamagotchi-style statusline pet that grows with your context window.
|
|
342
|
+
- [AIWatch](https://ai-watch.dev) - Live status monitor for 30+ AI APIs and apps; pairs with a Custom Command widget to surface provider outages in your status line.
|
|
343
|
+
|
|
344
|
+
|
|
345
|
+
## ๐ Acknowledgments
|
|
346
|
+
|
|
347
|
+
- Built for use with [Claude Code CLI](https://claude.ai/code) by Anthropic
|
|
348
|
+
- Powered by [Ink](https://github.com/vadimdemedes/ink) for the terminal UI
|
|
349
|
+
- Made with โค๏ธ for the Claude Code community
|
|
350
|
+
|
|
351
|
+
<br />
|
|
352
|
+
|
|
353
|
+
## Star History
|
|
354
|
+
|
|
355
|
+
<a href="https://www.star-history.com/#sirmalloc/ccstatusline&Timeline">
|
|
356
|
+
<picture>
|
|
357
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=sirmalloc/ccstatusline&type=Timeline&theme=dark" />
|
|
358
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=sirmalloc/ccstatusline&type=Timeline" />
|
|
359
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=sirmalloc/ccstatusline&type=Timeline" />
|
|
360
|
+
</picture>
|
|
361
|
+
</a>
|
|
362
|
+
|
|
363
|
+
<div align="center">
|
|
364
|
+
|
|
365
|
+
### ๐ Show Your Support
|
|
366
|
+
|
|
367
|
+
Give a โญ if this project helped you!
|
|
368
|
+
|
|
369
|
+
[](https://github.com/sirmalloc/ccstatusline/stargazers)
|
|
370
|
+
[](https://github.com/sirmalloc/ccstatusline/network/members)
|
|
371
|
+
[](https://github.com/sirmalloc/ccstatusline/watchers)
|
|
372
|
+
|
|
373
|
+
[](https://www.npmjs.com/package/ccstatusline)
|
|
374
|
+
[](https://www.npmjs.com/package/ccstatusline)
|
|
375
|
+
[](https://github.com/sirmalloc/ccstatusline/blob/main/LICENSE)
|
|
376
|
+
[](https://bun.sh)
|
|
377
|
+
|
|
378
|
+
[](https://github.com/sirmalloc/ccstatusline/issues)
|
|
379
|
+
[](https://github.com/sirmalloc/ccstatusline/pulls)
|
|
380
|
+
[](https://github.com/sirmalloc/ccstatusline/graphs/contributors)
|
|
381
|
+
|
|
382
|
+
### ๐ฌ Connect
|
|
383
|
+
|
|
384
|
+
[Report Bug](https://github.com/sirmalloc/ccstatusline/issues) ยท [Request Feature](https://github.com/sirmalloc/ccstatusline/issues) ยท [Discussions](https://github.com/sirmalloc/ccstatusline/discussions)
|
|
385
|
+
|
|
386
|
+
</div>
|