mcpField
Z
zenmux-statusline

zenmux-statusline

github.com/zenmuxエージェントワークフロー20342 回インストール7 週間前に更新
リポジトリ

zenmux-statusline について

zenmux-statuslineは、Claude Codeのステータスラインを設定し、セッション情報とZenMuxアカウント情報を表示するスキルです。管理キーがなくてもセッション情報を表示し、設定方法を案内します。

主な機能

  1. 01モデル、ディレクトリ、Gitブランチの表示
  2. 02コンテキスト使用量の表示
  3. 03プロンプトキャッシュの読み書き量表示
  4. 04ZenMuxのプランとクォータ表示
  5. 05残高とマスク済みキーの表示

活用シーン

  1. 01Claude Codeでセッション状態を確認
  2. 02ZenMuxのプランとクォータを確認
  3. 03キーがない場合に設定方法を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zenmux/skills --skill zenmux-statusline

インストール後、Claude Code で/zenmux-statuslineを入力して読み込まれたか確認します。

同梱ファイルscripts/zenmux-statusline.sh

詳細

zenmux-statusline

標準のセッション情報とともに、ZenMux アカウント情報をリアルタイムで表示する Claude Code のステータスラインをインストールします。

ステータスラインのスクリプトは、このスキルを基準とした相対パス scripts/zenmux-statusline.sh に含まれています。次の2行で表示されます。

Line 1: [model-slug] 📁 dir | 🌿 branch | █████░░░░░ 58% ctx | 💾 r72.0k w5.0k
Line 2: ⚡ Ultra | 🔑 Sub sk-ss-...6e6 | 5h █░░░░ 19% · 7d █░░░░ 24% | 💳 Bal $492.74

ZENMUX_MANAGEMENT_KEY が設定されていない場合は、2行目にセットアップのヒントが表示されます。

Line 2: ⚙ Set ZENMUX_MANAGEMENT_KEY to display account data → zenmux.ai/platform/management

次の手順を順番に実行してください。

ステップ1 — 前提条件を確認する

1a. curl と jq が利用可能か確認する
command -v curl && command -v jq

いずれかが見つからない場合は、インストールするようユーザーに伝えてください（macOS では brew install jq、それ以外では適切なパッケージマネージャーを使用します）。

1b. Management API Key を確認する
echo "${ZENMUX_MANAGEMENT_KEY:+set}"

  • 出力が set の場合 — ステップ2に進みます。

  • 空の場合 — ユーザーに次のように伝えます。

    ステータスラインでアカウントデータを取得するには、ZENMUX_MANAGEMENT_KEY が必要です。 https://zenmux.ai/platform/management でキーを作成し、シェルのプロファイルに追加してください。

    export ZENMUX_MANAGEMENT_KEY="sk-mg-v1-..."

    キーがなくても、ステータスラインにはセッション情報（モデル、git、残りのコンテキスト）が表示され、2行目には設定方法のヒントが表示されます。

    キーがなくても処理を続けられます — スクリプトは適切に動作を継続し、設定方法のヒントを表示します。

ステップ2 — ステータスラインのスクリプトをインストールする

バンドルされたスクリプトの絶対パスを特定します。この SKILL.md と同じ場所にあります。

SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
# Falls back to the skill directory path from the skills install location

Claude Code の設定ディレクトリにコピーします。

cp "SKILL_SCRIPTS_DIR/zenmux-statusline.sh" ~/.claude/zenmux-statusline.sh
chmod +x ~/.claude/zenmux-statusline.sh

ここで SKILL_SCRIPTS_DIR は、このスキル内の scripts/ ディレクトリです。実際に解決されたパスを使用してください。

ユーザーがすでに ~/.claude/statusline*.sh ファイルを持っている場合、置き換えられることを伝え、上書きする前に確認してください。

ステップ3 — Claude Code の設定を行う

ユーザーの現在の設定を読み込みます。

cat ~/.claude/settings.json

statusLine フィールドを新しいスクリプトを参照するように更新します。それ以外の設定はすべて保持してください。設定の例：

{
  "statusLine": {
    "type": "command",
    "command": "sh ~/.claude/zenmux-statusline.sh",
    "refreshInterval": 120
  }
}

refreshInterval: 120 によって、スクリプトは120秒ごとに再実行されます。これにより、アイドル状態の間も ZenMux データが更新され、キャッシュ TTL と一致します。

Edit ツールを使用して設定ファイルを更新してください。既存の JSON 構造を保持するよう注意してください。

ステップ4 — インストールを確認する

モック入力を使ってスクリプトをテストし、エラーなく実行されることを確認します。

echo '{"model":{"id":"test-model"},"workspace":{"current_dir":"'$(pwd)'"},"context_window":{"used_percentage":0},"session_id":"verify-install"}' | sh ~/.claude/zenmux-statusline.sh

出力が1行以上表示されれば、インストールは成功です。

ユーザーに次のように伝えます。

ステータスラインをインストールしました。次回 Claude Code を操作したときに、画面下部に表示されます。

表示内容：

  • 1行目：モデルのスラッグ、ディレクトリ、git ブランチ、コンテキスト使用量バー、直近の呼び出しにおけるプロンプトキャッシュの読み取り／書き込み
  • 2行目：ZenMux のプラン階層、API キーの種類とマスク済みのキー、色分けされたバー付きの5時間および7日間のクォータ使用量、PAYG ウォレット残高

色：

  • コンテキスト使用量：緑（70% 未満）、黄色（70～89%）、赤（90% 以上）
  • クォータ使用量：緑（70% 未満）、黄色（70～89%）、赤（90% 以上）

**キャッシュ：**ステータスラインの動作を高速に保つため、ZenMux API のデータは120秒間キャッシュされます。Git データは5秒間キャッシュされます。

後で削除するには、~/.claude/settings.json から statusLine フィールドを削除してください。

コミュニケーションのガイドライン

  • ユーザーが使用する言語で返信してください（中国語 → 中国語、英語 → 英語）。
  • いずれかの手順が失敗した場合は、次に進む前にエラーを明確に診断し、修正方法を提案してください。
  • 変更内容をユーザーに示さずに ~/.claude/settings.json を変更しないでください。

コメント

Markdown 対応