Kato

Claude Code 向け Kato

Kato はエージェントの目と耳です。Mac 上で動作し、クライアントとの通話を聞いて、クライアントごとに記録します。このプラグインを使うと、クライアントのフォルダーで作業するエージェントが、貼り付けなしで、何が話され、示され、約束されたかを尋ねられます。エージェントが完了したと報告した内容は、「完了との報告、未検証」と表示されます。

Kato アプリが必要です

このリポジトリに含まれるのはプラグインのみです。Kato アプリはオープンソースではなく、別売りです。 料金は月額 29 米ドルで、7 日間のトライアル付きです。開始時にカード情報が必要です。installkato.com からご利用ください。macOS 14 以降（通話の双方で使う場合は 14.4 以降）を搭載した Apple Silicon Mac で動作します。アプリがなければ、このプラグインはその旨を伝えるだけで、何もできません。

インストールする前に、アプリの動作をご確認ください。会議アプリまたはブラウザーが前面にあり、マイクが使用中であれば、通話の種類（クライアントとの通話か個人的な通話か）を問わず、自動で起動します。通話中以外は、現在開いているウィンドウのテキストを読み取ります。音声は Mac 上に保持され、文字起こしとウィンドウのテキストはホストされたブレインに送られ、Mac 上の台帳に記録されます。詳細はプライバシーページをご覧ください。

このプラグインの動作と送信内容

• bin/kato-mcp.sh は、起動したフォルダー内で（Claude のデスクトップアプリでは、選択したクライアントフォルダー内で）、stdio 経由のローカルサーバー ~/.local/bin/kato mcp ~/kato を起動します。このファイルが見つからない場合は、Kato の入手先を表示して停止します。Claude のデスクトップアプリでは、代わりにすべてのツール呼び出しがそのリンクを返します。フォルダーがまだ選択されていない場合や、選択したフォルダーがなくなった場合も同様です。
• hooks/session-start.sh はセッション開始時に同じローカルツールを実行し、このフォルダーに紐付けられたクライアントの新着情報を最大 5 行で表示します。Kato がインストールされていない場合は、1 行だけ表示します。
• skills/whats-new は、エージェントにいつ尋ねるべきかを伝えます。

このプラグインはネットワーク接続を開かず、キーも持ちません。

インストール

1. 上記のリンクからアプリをインストールし、トライアルを開始します。
2. Kato の右クリックメニューからコマンドラインツールをインストールします。
3. シェルで次を実行します。

claude plugin marketplace add manduks/kato-mcp
claude plugin install kato@kato

その後、/reload-plugins を実行するか、新しいセッションを開始してください。サーバーは ~/kato のブレインを読み込みます。それ以外の場所では、代わりに kato connect <brain> を使ってください。これにより、Cursor、Codex、OpenCode にも Kato が登録されます。いずれか一方を選んでください。両方を使うと、Claude Code にツールが重複して表示されます。

Claude のデスクトップアプリ

Claude のデスクトップアプリは Kato をフォルダー内で起動しないため、フォルダーを選択する必要があります。最新リリースから kato-mcp.mcpb をダウンロードして開き、インストールを押すと、Claude で Kato が有効になります。次に、「設定」＞「拡張機能」＞「Kato」を開き、クライアントフォルダーを選択します。選択するまでは、すべての Kato ツールがその手順を返します。まずそのフォルダーをクライアントに紐付けてください（次のセクション）。クライアントに紐付けられていないフォルダーでは、すべてのツールが要求を拒否します。Claude のアプリ内の Kato は、そのフォルダーのクライアントについてのみ回答します。--all を付けて紐付けた場合は、すべてのクライアントについて回答します。Claude のアプリ内の会話はすべて、この 1 つのフォルダーを使います。

フォルダーをクライアントに紐付ける

フォルダーが紐付けられるまでは、エージェントは何も得られません。また、Kato にクライアントが登録されるのは、そのクライアントに対して呼び出しを行ったとき（呼び出しが終了すると、Kato がどのクライアントかを尋ねます）か、アプリのセットアップ時に名前を指定したときだけです。そのため、新規インストールでは最初の呼び出しを行うまで何も返しません。その後は次のとおりです。

kato spaces ~/kato
kato bind ~/kato <client> <dir>

クライアントに紐付けられたフォルダーからは、kato サーバーのすべてのツール（whats_new だけでなく、トランスクリプト、メモ、コミットメント、検索、ブリーフを含む）で、そのクライアントのみが参照できます。 別のクライアントを要求すると、コンテンツなしで拒否されます。どのクライアントにも紐付けられていないフォルダーでは、すべてのツールが拒否を返し（クライアント名は示しません）、フックは何も出力しません。すべてのクライアントをエージェントに参照させる、自分専用のオペレーター用ワークスペースでは、次のようにします。

kato bind ~/kato --all <dir>

これは手動でのみ設定されます。Kato がこれを学習したり推測したりすることはありません。kato bind ~/kato --unbind <dir> は、どちらの種類の紐付けも解除します。

2 つ以上の git リポジトリを含むフォルダー（自身には .git がない場合）は、紐付けるとクライアントがそれらすべてに適用されてしまうため、拒否されます。拒否メッセージには、見つかったリポジトリが列挙されます。1 つだけを含むフォルダーは紐付けられ、kato bind はその 1 つのプロジェクトを指定して、参照対象にします。後になって Kato が、そのプロジェクトは別のクライアントのもの（そのクライアント用に使うのを確認済みのフォルダー）だと認識した場合、ユーザー自身が紐付けるまでは、そのプロジェクトのフォルダーはどのクライアントにも応答しません。フォルダーを完全に読み取れない（権限がない）場合は、すでに 2 つのリポジトリが見つかっている場合を除き、拒否されます。隠しフォルダー（.founder、.claude）と依存関係フォルダー（node_modules、vendor、third_party、Carthage、Pods）は数に含めません。プロジェクトが 1 つなら、その中で git init を実行すると紐付け可能になります。フォルダー内のすべてのリポジトリがそのクライアントに属している場合は、そのまま紐付けてください。

kato bind ~/kato <client> <dir> --wide-ok

--wide-ok は紐付けとともに記録され、そのルールだけを解除します。ホームフォルダー、/、/tmp、およびホーム直下にある git ではないフォルダーは、引き続き拒否されます。 Kato は紐付け時に一度だけ、フォルダーに何が含まれているかを確認します。そのため、後から紐付け済みフォルダーにリポジトリをクローンしても、そのフォルダーが応答するクライアントは変わりません。（Kato が独自に学習した行は、そのフォルダーで最初のセッションが開始されたときに確認されます。） --unbind を実行すると、フォルダーはどのクライアントにも応答しなくなります。別のクライアントに紐付けられたフォルダー内にある場合や、--all フォルダーの場合も同様です。実行後、そのフォルダーがどう応答するか（および、そのほかのフォルダーが再びどの外側のフォルダーから応答を受けるか）が示されます。 パスがシンボリックリンクを経由するようになった紐付け済みフォルダー、または Kato が agent/work-roots.json から読み取れない紐付けは、再度紐付けるまでどのクライアントにも応答しません。

Codex

スキルには共通の skills/<name>/SKILL.md レイアウトを使用します。OpenAI のドキュメントでは .claude-plugin/marketplace.json をレガシー互換のマーケットプレイスの場所として記載していますが、Claude の plugin.json を読み取ることについては記載されていません。そのため Codex では kato connect を使用してください（~/.codex/config.toml に [mcp_servers.kato] が登録されます）。ディレクトリ送信では Codex のプラグインフックはサポートされていません。

プライバシー

プラグインとそのサーバーは Mac 上で動作し、ネットワーク接続を開きません。前述のとおり、アプリ自体はトランスクリプトとウィンドウのテキストをホストされたブレインに送信します。 エージェントへの回答は、デフォルトで編集されます（[REDACTED:...]）。 シールドされたクライアントは、すべてのツールでルーティング情報（いつ、誰と）だけを返し、コンテンツは返しません。 kato MCP サーバーを通じて、1 つのクライアントに紐付けられたフォルダーが別のクライアントのコンテンツを受け取ることはありません。

明確に言うと、この境界が紐付けるのは、MCP 経由でのみ Kato にアクセスするエージェントです。シェルコマンドを実行できるエージェントは、kato transcript を実行したり、ブレインのファイル（~/kato）を直接読み取ったりできます。フォルダーの紐付けでは、それを防げません。ターミナルはユーザー自身のプロセスであるため、CLI では --space を引き続き使用できます。

フックは、解析できるダイジェストのみを出力します（kato new --digest の JSON 1 行）。new を認識しない古い kato は何も出力しません。ダイジェストの書き込みが完了し、かつフックがそれを出力する時間がまだ残っている場合（5 秒のうち 3.5 秒まで）に限り、フォルダーの位置を先に進めます。そのため、起動が遅いとニュースを飛ばすのではなく、次のセッションでもう一度表示します。