macOS companion app

メニューバー

表示内容

現在のエージェント作業状態を、メニューバーアイコンとメニューの最初のステータス行に表示します。
作業がアクティブな間はヘルスステータスを非表示にし、すべてのセッションがアイドルになると再表示します。
ルートの「コンテキスト」サブメニューには、最近のセッションをルートメニュー内で直接展開する代わりに格納します。
ルートメニューの「ノード」ブロックには デバイス のみ（node.list 経由のペアリング済みノード）を表示し、クライアント/プレゼンス項目は表示しません。
プロバイダー使用状況のスナップショットが利用可能な場合、コンテキストの下にルートの「使用状況」セクションが表示され、利用可能な場合は使用コストの詳細が続きます。

状態モデル

セッション: イベントは runId（実行ごと）とペイロード内の sessionKey を伴って到着します。「main」セッションはキー main です。存在しない場合は、直近に更新されたセッションへフォールバックします。
優先順位: main が常に優先されます。main がアクティブな場合、その状態を即座に表示します。main がアイドルの場合、直近でアクティブだった main 以外のセッションを表示します。アクティビティ中に表示を頻繁に切り替えることはありません。現在のセッションがアイドルになるか、main がアクティブになったときだけ切り替えます。
アクティビティ種別:
- job: 高レベルのコマンド実行（state: started|streaming|done|error）。
- tool: toolName と meta/args を伴う phase: start|result。

IconState enum（Swift）

idle
workingMain(ActivityKind)
workingOther(ActivityKind)
overridden(ActivityKind)（デバッグオーバーライド）

ActivityKind → グリフ

exec → 💻
read → 📄
write → ✍️
edit → 📝
attach → 📎
デフォルト → 🛠️

視覚的な対応

idle: 通常の critter。
workingMain: グリフ付きバッジ、フルティント、脚の「作業中」アニメーション。
workingOther: グリフ付きバッジ、控えめなティント、走り回る動きなし。
overridden: アクティビティに関係なく、選択されたグリフ/ティントを使用します。

コンテキストサブメニュー

ルートメニューには、セッション数/ステータスを表示してサブメニューを開く「コンテキスト」行が 1 つ表示されます。
コンテキストサブメニューのヘッダーには、過去 24 時間のアクティブセッション数が表示されます。
各セッション行は、トークンバー、経過時間、プレビュー、thinking/verbose、リセット、compact、削除の各アクションを保持します。
読み込み中、切断中、セッション読み込みエラーのメッセージは、コンテキストサブメニュー内に表示されます。
プロバイダー使用状況と使用コストの詳細は、サブメニューを開かなくても一目で確認できるように、コンテキストの下のルートレベルに残ります。

ステータス行テキスト（メニュー）

作業がアクティブな間: <Session role> · <activity label>
- 例: Main · exec: pnpm test、Other · read: apps/macos/Sources/OpenClaw/AppState.swift。
アイドル時: ヘルス概要へフォールバックします。

イベント取り込み

ソース: control-channel の agent イベント（ControlChannel.handleAgentEvent）。
解析されるフィールド:
- 開始/停止用の data.state を伴う stream: "job"。
- data.phase、name、任意の meta/args を伴う stream: "tool"。
ラベル:
- exec: args.command の最初の行。
- read/write: 短縮されたパス。
- edit: パスに加えて、meta/diff 件数から推測した変更種別。
- フォールバック: ツール名。

デバッグオーバーライド

設定 ▸ デバッグ ▸ 「アイコンオーバーライド」ピッカー:
- System (auto)（デフォルト）
- Working: main（ツール種別ごと）
- Working: other（ツール種別ごと）
- Idle
@AppStorage("iconOverride") 経由で保存され、IconState.overridden にマッピングされます。

テストチェックリスト

main セッションジョブをトリガーする: アイコンが即座に切り替わり、ステータス行に main ラベルが表示されることを確認します。
main がアイドルの間に main 以外のセッションジョブをトリガーする: アイコン/ステータスが main 以外を表示し、完了するまで安定していることを確認します。
他のセッションがアクティブな間に main を開始する: アイコンが即座に main に切り替わります。
短時間のツールバースト: バッジがちらつかないことを確認します（ツール結果に対する TTL 猶予）。
すべてのセッションがアイドルになると、ヘルス行が再表示されます。

関連