Masko for Claude Code

Masko for Claude Codeは、Claude Codeのセッションを追跡するmacOSオーバーレイ。許可プロンプトをリアルタイム表示し、切替なしで承認。

Masko for Claude Codeとは？

Masko for Claude Codeは、無料のオープンソースmacOSデスクトップコンパニオンです。Claude Codeセッションの横にアニメーション付きマスコットオーバーレイを表示します。セッション活動をリアルタイムで追跡し、Claudeが許可や注意を必要とする際に表示され、コーディングワークフローを切り替えずにアクションを承認・拒否できます。

アプリは軽量オーバーレイウィンドウとして動作し、各Claudeセッションの観測性ダッシュボードを提供します。セッション状態、アクティビティフィード、許可プロンプトを表示し、Claude Codeのフックシステムによりすべてローカルで動作します。

主な機能

Claude Code用のmacOSオーバーレイマスコット: マスコットが他のウィンドウの上にフロート表示され、現在のセッション状態（例: アイドル、作業中、注意）に基づいて更新されます。
リアルタイム許可処理: Claudeがコマンド実行を求めると、オーバーレイがキーボードからの許可/拒否フローを提供し、マウス切り替えを不要にします。
通知ダッシュボード: セッションのスナップショット（例: 実行中/入力待ち/コンパクト中）、色分けされたイベントフィード、セッションサマリーを表示します。
サブエージェント追跡: メインセッションを超えた子エージェントをリアルタイムで監視し、何が起きているかを確認できます。
キーボード優先セッション制御: セッション切り替え、Claude Codeを実行中のターミナルタブへのジャンプ、許可アクション確認のためのショートカットを含みます。
ローカル優先動作: Claude Codeのフックシステムでイベントメタデータ（ツール名、セッション状態）を受信しますが、コードは読みません。サーバーにコードを送信せずローカルで動作します。

Masko for Claude Codeの使い方

macOSにダウンロード・インストール: 提供されたmacOS DMGからインストール。アプリはDockを散らかさずメニューバーに常駐します。
アクセシビリティ権限を一度付与: 初回起動時、Claude Codeフックを自動インストールし、オーバーレイ用のアクセシビリティ権限を求めます。
Claude Codeを起動: ターミナルを開き、通常通りClaude Codeを実行してアプリがセッションを観測できるようにします。
オーバーレイから操作: プロンプト時（例: Claudeがコマンド実行や質問）、キーボードショートカットで承認/拒否し、正しいターミナルタブにフォーカスします。
マスコットを選択: デフォルトの6種類から選択、またはmasko.aiからカスタムマスコットをデスクトップアプリにロードします。

ユースケース

コンテキストスイッチなしでClaude Codeコマンドを承認: Claudeが実行許可を求めると（例: ビルドコマンド）、オーバーレイがキーボードからの迅速な許可/拒否アクションを表示します。
複数セッションでClaudeの動作を追跡: セッション切り替えとターミナルジャンプで複数Claudeセッションを管理し、各セッションに紐づく正確なターミナルタブに移動できます。
セッション活動とツールコールをレビュー: 通知ダッシュボードで順序付きイベント（ツールコール、完了）を確認し、セッションの変化を理解します。
「入力待ち」状態を処理: セッションが入力待ちを示すと、ダッシュボードと通知で状態を特定し迅速に応答できます。
サブエージェント依存のエージェント活動を追跡: ワークフローが子エージェントをトリガーすると、サブエージェント追跡でリアルタイム活動を表示し、完全な実行パスを追従できます。

FAQ

Masko for Claude Codeは無料ですか？ はい。デスクトップコンパニオンは無料・オープンソースで、MITライセンスです。

MaskoはサーバーやAPIキーを必要としますか？ いいえ。設定ファイル、サーバー、APIキーは不要で、すべてローカルで動作します。

Maskoは何を収集し、コードを読みますか？ MaskoはClaude Codeのフックシステムを使い、ツール名やセッション状態などのイベントメタデータを受信します。コードは読みません。

マスコットはどう動作しますか？ アプリにデフォルトで6種類のマスコットが含まれます。masko.aiからカスタムマスコットをデザイン・ロードしてデスクトップアプリに使用できます。

Maskoで正しいターミナルにジャンプできますか？ はい。オーバーレイがClaude Code実行中のターミナルタブに即座フォーカスするショートカットを提供し、ページ記載のターミナル・エディタ（例: iTerm2、Terminal.app、VS Code、Ghostty）をサポートします。

代替案

ターミナル/エディタ内蔵アプローチ（オーバーレイなし）: ターミナルやIDE内のClaude Codeのプロンプトに頼り、その場で応答。常時表示のオーバーレイとダッシュボードを使わず、注意を切り替える点が異なります。
一般的なmacOS通知/自動化ツール: 通知ルーティングやキーボード自動化でプロンプトとアクションを強調。一般的なもので、Claude Code特有のセッション監視やマスコットベースの状態表示が得られない場合があります。
他の開発者生産性オーバーレイ: 開発ワークフローのセッション追跡とクイックナビゲーションを提供するツールを探す。通常はコードナビゲーションやチャット履歴に焦点を当て、Claude Codeの許可プロンプトやセッションイベントフィードには向きません。
CLIオンリーのワークフローと手動許可確認: コマンドラインからClaude Codeを操作し、実行前にコマンドを手動確認。最大限のシンプルさを提供しますが、オーバーレイからのリアルタイムダッシュボード表示やワンクリック/キーボード承認がありません。