sirmalloc/ccstatusline

🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.

ccstatusline とは何か？

ccstatusline は Node.js パッケージ であり、Claude Code コマンドラインインターフェース（Anthropic の Claude モデル用の公式 CLI）に高度にカスタマイズ可能なステータスラインを追加します。Claude Code から現在のモデル、トークン使用量、Git 情報、サンドボックス状態など、さまざまなデータを読み取り、ターミナルの下部にカラフルで設定可能なラインとしてレンダリングします。

なぜ使うべきか？

リアルタイムの AI セッションメトリクス – ターミナルから離れることなく、使用したトークン数、残りのコンテキスト量、週間使用量を確認できます。
Git 統合 – ブランチ名、PR/MR リンク、ファイルステータスのカウント、CI 状態が AI 情報と併せて表示されます。
高度なカスタマイズ – 表示するウィジェット、順序、色、グラデーション、Powerline セパレータ、最小モードの純粋な値などを自由に選択できます。
クロスプラットフォーム – macOS、Linux、Windows で動作（ヘルパー窓を非表示にする特別な処理あり）。
設定のエクスポート可能 – JSON に設定を保存・読み込み可能で、複数のマシン間でレイアウトを簡単に共有できます。

コア機能（README に記載）

カテゴリ	ウィジェット / 機能
モデルと使用状況	モデル名、入力/出力トークン、合計トークン、使用率、週間使用量、追加使用（従量課金）ウィジェット、コンテキスト窓サイズ、コンパクションカウンター、キャッシュヒット/読み取り/書き込み率。
Git と CI	ブランチ名、ルートディレクトリ、PR/MR リンク（GitHub および GitLab）、ステータス（前方/後方、競合、ステージング/未ステージング/未追跡ファイル）、CI チェック要約、クリック可能なリンク、幅制限付き表示（省略表示あり）。
環境	現在の作業ディレクトリ（オプションのギフト付き）、サンドボックス状態、音声入力状態、Claude アカウントメール、セッション名、メモリ使用量、ターミナル幅のオーバーライド。
視覚	Powerline および flex セパレータ、ウィジェット単位またはライン全体のカラーフラッド、カスタムギフト、薄めスタイル、ミニマリストな純粋値モード、グラデーションプリセット、カスタム Unicode セパレータ。
コントロール	ウィジェットの追加・並べ替え・複製・削除ができる TUI エディタ；ファジーなウィジェットピッカー；カラーピッカー；設定のインポート/エクスポート；バージョンフラグ（`ccstatusline --version`）。
パフォーマンス	ディスクキャッシュを使用した非ブロッキングな Git/CI 更新、古いデータのバックグラウンド更新、キャッシュされたブロックタイマーのメトリクス、設定可能なキャッシュTTL、無効な `settings.json` の安全な処理。
プラットフォームの利便性	Windows の UTF-8 対応、隠しヘルパープロセス、使用量API用の環境変数プロキシサポート、ピン止めされたグローバルインストールの安全な処理。

すぐに始めよう（クイックスタート）

インストール – npm i -g ccstatusline（Bun でも可）。対応プラットフォーム用の事前ビルドバイナリが同梱されています。
実行 – インストール後、Claude Code CLI を起動するとステータスラインが自動的に表示されます。また、ccstatusline を直接実行して設定をプレビューすることもできます。
設定 – TUI で e を押してエディタを開き、ウィジェットの追加・削除、色の変更、Powerline モードへの切り替えが可能です。設定は ~/.config/ccstatusline/settings.json（または --config でカスタムパス指定）に保存されます。
エクスポート／インポート – バージョン 2.2.27 以降の Config import/export ウィジェットを使用して、現在のレイアウトを JSON にダンプし、編集して再インポートできます。

誰がメンテナンスしていますか？

リポジトリは sirmalloc が所有しており、頻繁なリリース、コミット活動グラフ、および「Maintained? yes」バッジから積極的なメンテナンスが確認できます。また、Awesome Claude Code カテゴリに掲載されており、ClaudeLog 知識ベースでも参照されています。

ライセンス

MIT – コードを自由に使用・変更・再配布できます。

TL;DR

ccstatusline は Claude Code CLI をダッシュボード化するターミナルUIアドオンであり、モデル使用状況、Gitコンテキスト、CIステータス、その他多数のメトリクスを、JSONバックエンドのTUIにより高度にカスタマイズ可能です。開発者がターミナルで Claude を使うために、本物で活発にメンテナンスされているオープンソースツールです。