claudlet — Claude Code の作業状況を可視化するピクセルデスクトップペット

ターミナルのスクロールだけを見ながら、「Claude は今コードを書いているのか、ファイルを探っているのか、自分の返答を待っているのか」ともどかしく感じたことはありませんか？
claudlet は、Claude Code の現在の作業状態を直感的かつかわいく見せてくれる、反応型のデスクトップピクセルペットです。

主な機能

• リアルタイム状態同期: タイピング、ファイル読み込み、思考中、待機など、Claude のフック（Hook）を検知し、ペットの動きや表情として即座に表示します。
• サブエージェントの可視化: Claude がサブエージェントを呼び出すと、安全帽をかぶった小さな同僚が現れ、後ろをついて回りながら作業をまねします。
• ウィンドウ操作 & 物理エンジン: やることがないと、アクティブなウィンドウ枠の上を歩き回ります。マウスでつかんで投げると放物線を描いて飛び、ウィンドウの端を踏んでジャンプもします。
• セッションごとの 1:1 マッチング: 複数のセッションを開くと、ペットも複数匹登場します。ペットをクリックすると、該当する Claude セッションのターミナルウィンドウを最前面に表示します。

技術的特徴（How it works）

• Zero-Asset（純粋なコードレンダリング）: PNG のような外部画像リソースは一切ありません。すべてのアートワークとアニメーション（バウンス、スクワッシュ&ストレッチなど）を QPainter を使ってピクセル単位でコードから直接描画しています。そのため、ライセンスの負担なく自由に利用・変更できます。
• 安全なノンブロッキングアーキテクチャ: Hook → TCP ソケット → ペットプロセス という構造です。ペットが終了していたりエラーが発生したりしても、静かに接続に失敗するだけで、Claude Code 本来の作業を妨げることは決してありません（不変条件を保証）。
• クロスプラットフォームのネイティブウィンドウ認識: Windows（Win32）、macOS（Quartz）、Linux（KDE Plasma/XWayland）環境で OS ごとのネイティブ API を呼び出し、ウィンドウの位置を正確に追跡してその上に乗ります。

例

[IMG] デモ 1
[IMG] デモ 2
[IMG] デモ 3

インストールと実行

pipx install claudlet && claudlet-install  

• 1 つのコマンドでフックと /claudlet スキルが冪等（Idempotent）に自動登録されます。
• 以後、新しい Claude Code セッションを開くとペットが自動的に現れます。

---