﻿デスクトップペット(オレンジちゃん / ACK) はじめに
====================================================

Windows のデスクトップに常駐する小さなペットです。
Claude Code が「承認待ち」になると、ペットの上に通知が出て知らせてくれます。

■ 中身
  オレンジちゃん.exe             … オレンジちゃんで起動
  ACK.exe                        … ACK(ロボット)で起動。中身は同じで、ボタンで切り替えられます
  DesktopPetTerminalFocus.vsix   … VS Code 用の補助拡張(必要な人だけ)
  source\                        … ソース一式と、自分でビルドするための build-blog.ps1

■ 動く環境
  Windows 10 / 11、.NET Framework 4.8 以降(Windows に標準で入っています)。
  ペットだけなら、インターネット接続や Claude Code は不要です。

■ 使い始める
  1. ダウンロードした ZIP を右クリック →「プロパティ」→ 下の「許可する」(ブロックの解除)に
     チェックを入れて OK。そのあと「すべて展開」で、フォルダごと展開します。
     ZIP の中から直接 exe を起動しないでください。
  2. オレンジちゃん.exe(または ACK.exe)をダブルクリック。
  3. 「Windows によって PC が保護されました」(SmartScreen)と出た場合は、
     「詳細情報」→「実行」で起動できます。署名のない個人作成の exe のため表示されます。
     気になる場合は source\ のソースを読んで、build-blog.ps1 で自分でビルドしてください。
  4. 終了は、ペットを右クリック →「終了」。

■ 操作
  ・下の「−」「＋」:50〜100% でサイズ変更
  ・下の「ACK」「戻す」:キャラクター切り替え
  ・下の「隠す」:ペットを非表示(操作ボタンだけ残り、「表示」で戻せます)
  ・ドラッグ:移動 / クリック・ダブルクリック:モーション / 右クリック:メニュー
  ・サイズとキャラクターは exe の横の .settings ファイルに保存されます

■ Claude Code の承認待ち通知
  Claude Code が承認待ちになると、ペットの上にオレンジ色の通知が出ます。
  通知をクリックすると、承認待ちの会話がある画面(Windows Terminal のタブ、VS Code など)を前に出します。
  フックなどの設定は不要です。約2秒ごとに Claude Code のローカルの状態ファイル
  (ユーザーフォルダの .claude\sessions、CLAUDE_CONFIG_DIR を設定している場合はその下)を読んでいます。

  【注意】この状態ファイルは Claude Code の公式な仕組み(公開された仕様)ではありません。
  Claude Code のアップデートで中身が変わると、通知が出なくなる場合があります。
  (Claude Code 2.1.325 で動作を確認しています)

■ VS Code の内蔵ターミナルへ移動したい場合(任意)
  VS Code の「拡張機能」→ 右上の「…」→「VSIX からのインストール...」→
  DesktopPetTerminalFocus.vsix を選びます。
  通知クリック時に VS Code が「URI を開きますか」と聞いてきたら「開く」を選んでください。
  この拡張は、指定された番号(PID)のターミナルを表示するだけです。承認の操作や通信はしません。
  会社の PC では、拡張機能の導入ルールに従ってください。

■ うまくいかないとき
  ・起動しない:ZIP のブロックを解除してから展開したか確認
  ・設定が戻る:書き込みできるフォルダに展開する
  ・通知が出ない:同じ Windows ユーザーで動いている Claude Code か、承認待ち(通常の入力待ちではない)か確認
  ・タブを手動で改名している、同じ名前のタブが複数ある場合は、自動で選べないことがあります

■ ライセンス
  自由に改変・利用・再配布してかまいません。連絡も不要です。
  無保証です。利用は自己責任でお願いします。
