Project

公開中

Tiny Code Pet

Claude Code と Codex の作業状況・依頼全体の推定進捗・完了を、画面右下の小さなひよこで確認できる軽量な Windows デスクトップペット。Claude Code は CLI / VS Code に加え、Claude Code Desktop にも対応。

  • Windows 10 / 11
  • C# / Win32
  • MIT License
Tiny Code Pet の画面。デスクトップ右下にひよこのペットが表示され、作業中の状態と全体の推定進捗が出ている様子

なにをするアプリ?

Claude Code や Codex に作業を任せている間、ターミナルを見張っていないと進んでいるのか終わったのかが分かりません。 Tiny Code Pet は、その状態を画面右下の小さなひよことして常駐させます。

見える状態は「何もしていない」「作業中(+依頼全体の推定進捗)」「終わった」の 3 つだけ。 手を止めずに横目で確認できることを優先していて、確認を求める UI や警告音はありません。

できること

  • Claude Code + Codex

    1 匹のペットが両方を監視。どちらか片方だけでも使えます。

  • 依頼全体の推定進捗

    「今のタスク」ではなく、依頼全体の工程表から進捗を出します。

  • 完了だけを知らせる

    root Stop の後、一定時間その作業が再開されなければ「終わった!」。音が鳴るのは完了時の 1 回だけ。

  • 邪魔をしない

    クリック透過。タスクバーにも Alt+Tab にも出ず、フォーカスを奪いません。

  • 軽い

    イベント駆動のみでポーリングなし。待機中の CPU はほぼ 0。

  • prompt を読まない

    prompt・応答・ソース本文は一切読まず、状態のメタデータだけを扱います。

どう作った?

  • C# + Win32 API (P/Invoke) のネイティブ実装。Electron / WebView / Node 常駐なし
  • Claude Code の公式 Hooks と Codex の hooks からイベントを受け取る完全イベント駆動
  • 表示は Win32 のレイヤードウィンドウ。状態が変わったときだけ描画する
  • 進捗と完了判定は独立(進捗は工程表から、完了は停止+静穏から)
  • Claude Code Desktop にも対応。Desktop はプロセス構成が CLI / VS Code と異なり、既存の nested セッション判定が通知を抑制してしまうため、判定ロジックを調整した

GitHub

ソースコードは MIT ライセンスで公開しています。導入手順や仕組みの詳細は README にまとめてあります。