Clawd on Desk

English · 中文版 · 繁體中文 · 한국어 · 日本語

Clawd on Desk のアニメーションデモ。AI コーディングエージェントの状態に合わせて、ピクセルのカニが睡眠、思考、ツール実行中のタイピング、サブエージェント 1 個ではヘッドホングルーヴ、複数では3ボールジャグリング、権限リクエストの通知、タスク完了後のお祝いへリアルタイムに切り替わります。Claude Code、Codex、Cursor、Copilot、Gemini、Pi、OpenClaw などに対応しています。

Clawd はデスクトップに住むペットで、AI コーディングエージェントが今何をしているかにリアルタイムで反応します。長いタスクを開始したら席を外し、Clawd が完了を知らせたら戻ってくるだけです。プロンプトを入力すると考え、ツールが動くとタイピングし、サブエージェントが動くとヘッドホングルーヴや3ボールジャグリングになり、権限確認ではカードを表示し、タスク完了時には喜び、離席中は眠ります。組み込みテーマとして **Clawd**（ピクセルのカニ）、**Calico**（三毛猫）、**Cloudling**（云宝）を同梱し、カスタムテーマと Codex Pet アニメーションパックのインポートにも対応しています。 > Windows 11、macOS、Ubuntu/Linux に対応しています。Windows リリースでは x64 と ARM64 のインストーラーを個別に提供します。ソースから実行するには Node.js が必要です。**Claude Code**、**Codex CLI**、**Copilot CLI**、**Gemini CLI**、**Cursor Agent**、**CodeBuddy**、**Kiro CLI**、**Kimi Code CLI (Kimi-CLI)**、**opencode**、**Pi**、**OpenClaw**、**Hermes Agent** と連携します。 ## 機能 ### マルチエージェント対応 - **Claude Code** — command hook と HTTP permission hook による完全統合 - **Codex CLI** — official hooks を主経路にし、JSONL フォールバック（`~/.codex/sessions/`）も利用。自動登録され、実際の権限バブルに対応 - **Copilot CLI** — `~/.copilot/hooks/hooks.json` の command hook に対応 - **Gemini CLI** — `~/.gemini/settings.json` の command hook に対応（Clawd 起動時に自動登録、または `npm run install:gemini-hooks`） - **Cursor Agent** — `~/.cursor/hooks.json` の [Cursor IDE hooks](https://cursor.com/docs/agent/hooks) に対応（Clawd 起動時に自動登録、または `npm run install:cursor-hooks`） - **CodeBuddy** — `~/.codebuddy/settings.json` 経由で Claude Code 互換の command hook と HTTP permission hook に対応（Clawd 起動時に自動登録、または `node hooks/codebuddy-install.js`） - **Kiro CLI** — `~/.kiro/agents/` 配下のカスタムエージェント設定に command hook を注入。Clawd 起動時には Kiro 組み込みの `kiro_default` から再同期される `clawd` エージェントも自動作成されるため、`kiro-cli --agent clawd` または `/agent swap clawd` で挙動差を抑えながら hook を利用できます（Clawd 起動時に自動登録、または `npm run install:kiro-hooks`）。state hook は macOS と Windows で検証済みです。 - **Kimi Code CLI (Kimi-CLI)** — `~/.kimi/config.toml` の command hook（`[[hooks]]` エントリ）に対応（Clawd 起動時に自動登録、または `npm run install:kimi-hooks`） - **opencode** — `~/.config/opencode/opencode.json` 経由の [plugin integration](https://opencode.ai/docs/plugins) に対応（Clawd 起動時に自動登録）。遅延のないイベントストリーミング、Allow/Always/Deny 付きの権限バブル、`task` tool による並列サブエージェント生成時の building アニメーションに対応 - **Pi** — `~/.pi/agent/extensions/clawd-on-desk` のグローバル extension で連携します（Clawd 起動時に自動登録、または `npm run install:pi-extension`）。インタラクティブな Pi セッションの状態を報告し、`bash` / `write` / `edit` tool call では権限バブルを表示します。Clawd が利用できない場合は Pi ターミナル確認へフォールバックします - **OpenClaw** — `~/.openclaw/openclaw.json` の plugin path で state-only 連携します（OpenClaw config が既にある場合は Clawd 起動時に自動登録、または `npm run install:openclaw-plugin`）。Phase 1 はローカル `openclaw tui --local` セッションのアニメーションのみを対象とし、権限バブルやターミナルフォーカスには対応しません - **Hermes Agent** — Hermes の管理 plugin ディレクトリ経由の [plugin integration](https://hermes-agent.org/)（Hermes インストール済みの場合は Clawd 起動時に自動登録、または `npm run install:hermes-plugin`）。状態、セッション、SessionEnd、ターミナルフォーカスに対応 - **複数エージェントの共存** — すべてのエージェントを同時に動かせます。Clawd は各セッションを個別に追跡します ### アニメーションと操作 - **リアルタイムな状態認識** — agent hook とログポーリングが Clawd のアニメーションを自動で切り替えます - **12 種類のアニメーション状態** — idle、thinking、typing、building、headphones groove、multi-subagent juggling、error、happy、notification、sweeping、carrying、sleeping - **Codex Pet インポート** — `Settings...` → `Theme` から Codex Pet zip パッケージをインポートすると、Clawd が atlas アニメーションを管理テーマに変換します - **視線追従** — idle 状態では Clawd がカーソルを追い、体の傾きや影の伸びも変化します - **睡眠シーケンス** — 60 秒アイドルが続くと、あくび、うとうと、倒れ込み、睡眠へ移行します。マウス移動で驚いて起きるアニメーションが再生されます - **クリックリアクション** — ダブルクリックでつつき、4 回クリックでじたばたします - **どの状態からでもドラッグ** — いつでも Clawd をつかめます（Pointer Capture により素早いフリックでも取り落としません）。離すと元の状態へ戻ります - **Mini mode** — 右端へドラッグ、または右クリックの「Mini Mode」で有効化。Clawd が画面端に隠れ、ホバーで顔を出し、mini 通知やお祝い、放物線ジャンプの遷移を行います ### 権限バブル - **アプリ内権限レビュー** — Claude Code、Codex CLI、CodeBuddy、opencode、Pi がツール権限を要求すると、ターミナルで待つ代わりに Clawd がフローティングバブルカードを表示します - **許可 / 拒否 / エージェント固有の追加操作** — ワンクリックで承認または拒否できます。対応エージェントでは permission rule や `Always` 操作も利用できます - **グローバルホットキー** — 最新の権限バブルに対して `Ctrl+Shift+Y` で許可、`Ctrl+Shift+N` で拒否（バブル表示中だけ登録されます） - **スタックレイアウト** — 複数の権限リクエストは右下から上方向へ積み重なります - **自動消去** — 先にターミナルで回答した場合、バブルは自動的に消えます - **エージェントごとの切り替え** — `Settings...` → `Agents` でエージェントを選び、`Show pop-up bubbles` をオフにすると、そのエージェント自身のターミナル/TUI に確認を残せます ### セッション情報 - **マルチセッション追跡** — すべてのエージェントのセッションから、優先度の最も高い状態を解決します - **サブエージェント認識** — サブエージェント 1 個で headphones groove、2 個以上で three-ball juggling - **Sessions dashboard + HUD** — 右クリックまたは tray → `Open Dashboard` から live session、最近のイベント、エイリアス、ターミナルジャンプを確認できます。Clawd の近くにはコンパクトな HUD が表示され、現在の live session を見失いません - **ターミナルフォーカス** — Dashboard/HUD の操作で特定セッションのターミナルへジャンプできます。notification/attention 状態では関連するターミナルを自動で前面にします - **プロセス生存確認** — 対応エージェントのプロセスがクラッシュまたは終了したことを検知し、孤立セッションを片付けます - **起動時リカバリー** — Clawd の再起動時に対応エージェントがまだ動いていれば、眠らずに起きたままになります ### システム - **クリック透過** — 透明部分のクリックは背面ウィンドウへ通り、Clawd の体だけが操作対象になります - **位置の記憶** — 再起動後も最後に置いた場所を覚えます（mini mode を含む） - **単一インスタンスロック** — Clawd ウィンドウの重複起動を防ぎます - **自動起動** — Claude Code の SessionStart hook により、Clawd が起動していない場合に自動で起動できます - **Do Not Disturb** — 右クリックまたは tray メニューから sleep mode に入り、起こすまで hook event をすべて抑制します。DND 中は権限バブルも抑制されます。Codex と opencode はネイティブプロンプトに戻り、Pi はターミナル確認へフォールバックし、Claude Code と CodeBuddy は組み込みの権限フローに戻ります - **効果音** — タスク完了や権限リクエスト時に短い音を鳴らします（右クリックメニューで切り替え、10 秒クールダウン、DND 中は自動ミュート） - **システムトレイ** — サイズ変更（S/M/L）、DND mode、言語切り替え、自動起動、更新確認 - **i18n** — English、簡体中文、繁体中文、Korean、Japanese UI。右クリックメニューまたは tray から切り替えできます - **自動更新** — GitHub Releases を確認します。Windows では終了時に NSIS 更新を適用し、macOS/Linux では clone したリポジトリから実行している場合に `git pull` + restart を行います ## アニメーション

_Idle	_{Thought Bubble}	_Typing	_Building	_{1 Subagent}	_{2+ Subagents}
_{Calico Idle}	_{Calico Thinking}	_{Calico Typing}	_{Calico Building}	_{Calico Juggling}	_{Calico Conducting}
_{Cloudling Idle}	_{Cloudling Thinking}	_{Cloudling Typing}	_{Cloudling Building}	_{Cloudling Juggling}	_{Cloudling Conducting}

event-to-state mapping、mini mode、クリックリアクションの詳細: **[docs/guides/state-mapping.md](docs/guides/state-mapping.md)** ## マルチディスプレイ Clawd はマルチモニター環境に適応します。起動したディスプレイに合わせて比例サイズを決め、縦長モニターでは読みやすさを保つために上限付きで拡大し、ディスプレイ間のドラッグにも対応します。

_{実際のマルチモニター挙動は、このリポジトリ内のデモ動画で確認できます。}

## クイックスタート通常利用では、**[GitHub Releases](https://github.com/rullerzhou-afk/clawd-on-desk/releases/latest)** から最新のビルド済みインストーラーをダウンロードしてください。 - **Windows**: `Clawd-on-Desk-Setup--x64.exe` または `Clawd-on-Desk-Setup--arm64.exe` - **macOS**: `.dmg` - **Linux**: `.AppImage` または `.deb` インストール後に Clawd を起動してください。対応エージェントの hook/plugin は起動時に自動同期されます。ソースからの実行は、コントリビュート、未リリースコードのテスト、または連携のデバッグを行う場合だけを推奨します。ソースインストールでは Electron/build tooling をダウンロードし、大きな `node_modules` ツリーが作成されることがあります。 ```bash # リポジトリを clone git clone https://github.com/rullerzhou-afk/clawd-on-desk.git cd clawd-on-desk # 依存関係をインストール npm install # Clawd を起動（起動時に Claude Code hooks を自動登録） npm start ``` **Claude Code** と **Codex CLI** は自動登録される hook により、そのまま動作します。**Gemini CLI**、**Cursor Agent**、**CodeBuddy**、**Kiro CLI**、**Kimi Code CLI (Kimi-CLI)**、**opencode**、**Pi**、**OpenClaw**、**Hermes Agent** は、インストール済みかつ初期化済みであれば Clawd 起動時に自動登録されます。**Copilot CLI** だけは一度だけ hook setup が必要です。Remote SSH、WSL、macOS/Linux のプラットフォーム別メモも含めた詳細: **[docs/guides/setup-guide.md](docs/guides/setup-guide.md)** 公式の `Codex + WSL` ステータス、Clawd の現在の実装境界、そして誤解しやすい理由については、こちらを参照してください: **[docs/guides/codex-wsl-clarification.md](docs/guides/codex-wsl-clarification.md)** ## 既知の制限一部のエージェントには機能差があります（権限バブルなし、ポーリング遅延、ターミナルフォーカスなしなど）。完全な表はこちら: **[docs/guides/known-limitations.md](docs/guides/known-limitations.md)** ## カスタムテーマ Clawd はカスタムテーマに対応しています。標準のカニを、自分のキャラクターやアニメーションに置き換えられます。既存の Codex Pet パッケージがある場合は、`Settings...` → `Theme` → `Import pet zip` から取り込むと、Clawd が atlas を管理テーマへ自動変換します。 **クイックスタート:** 1. テーマを scaffold します。 ```bash node scripts/create-theme.js my-theme # または npm run create-theme -- my-theme ``` 引数なしでも動作します。ユーザーテーマディレクトリ内に、次に利用可能な `my-theme` scaffold を作成します。 2. `theme.json` を編集し、アセット（SVG、GIF、APNG、WebP、PNG、JPG、JPEG）を作成します 3. Clawd を再起動するか、`Settings...` → `Theme` → 自分のテーマを選択します **最小構成のテーマ:** SVG 1 個（視線追従付き idle）+ GIF/APNG 7 個（thinking、working、error、happy、notification、sleeping、waking）。視線追従を無効にすれば、すべての状態で任意の形式を利用できます。配布前にテーマを検証してください。 ```bash node scripts/validate-theme.js path/to/your-theme ``` `Settings...` → `Theme` のテーマカードには、`Tracked idle`、`Static theme`、`Mini`、`Direct sleep`、`No reactions` などの capability badge が表示されるため、ユーザーは切り替える前にテーマの対応範囲を確認できます。初心者から上級者までの段階別パス、`theme.json` のフィールドリファレンス、アセットガイドラインを含む完全な作成ガイドは [docs/guides/guide-theme-creation.md](docs/guides/guide-theme-creation.md) を参照してください。 > サードパーティ製 SVG ファイルは、セキュリティのため自動で sanitize されます。 ### Roadmap 今後検討したい項目です。 - `codex.exe` PID からのプロセスツリー lookup による Codex ターミナルフォーカス - Copilot CLI hooks の自動登録（Claude Code と同様） - テーマレジストリとアプリ内ダウンロード - アプリのクリーン削除用 hook uninstall script ## コントリビュート Clawd on Desk はコミュニティ主導のプロジェクトです。バグ報告、機能案、Pull Request を歓迎します。相談したい場合は [issue](https://github.com/rullerzhou-afk/clawd-on-desk/issues) を開くか、直接 PR を送ってください。 ### メンテナー

_{@rullerzhou-afk
鹿鹿 · creator}

_{@YOIMIYA66
maintainer}

### コントリビューター Clawd をより良くしてくれたすべての方に感謝します。

コントリビューター 47 人をすべて表示

_{PixelCookie-zyf}	_yujiachen-y	_AooooooZzzz	_purefkh	_{Tobeabellwether}	_Jasonhonghh	_crashchen
_hongbigtou	_InTimmyDate	_NeizhiTouhu	_{xu3stones-cmd}	_androidZzT	_Ye-0413	_WanfengzzZ
_TaoXieSZ	_ssly	_stickycandy	_Rladmsrl	_YOIMIYA66	_Kevin7Qi	_{sefuzhou770801-hub}
_Tonic-Jin	_seoki180	_{sophie-haynes}	_PeterShanxin	_{CHIANGANGSTER}	_{JaeHyeon-KAIST}	_hhhzxyhhh
_TVpoet	_zeus6768	_anhtrinh919	_tomaioo	_v-avuso	_livlign	_tongguang2
_Ziy1-Tan	_{tatsuyanakanogaroinc}	_yeonhub	_joshua-wu	_nmsn	_sunnysonx	_YuChenYunn
_jhseo-b	_Hwasowl	_{XiangZheng2002}	_keiyo118	_pan93412

## 謝辞 - Clawd のピクセルアートは [@marciogranzotto](https://github.com/marciogranzotto) による [clawd-tank](https://github.com/marciogranzotto/clawd-tank) を参考にしています - [LINUX DO](https://linux.do/) コミュニティで共有されました ## ライセンスソースコードは [GNU Affero General Public License v3.0](LICENSE) (AGPL-3.0) のもとでライセンスされています。 **Artwork および同梱テーマアセット（`assets/` と `themes/*/assets/` を含む）は AGPL-3.0 の対象外です。** すべての権利は各著作権者に帰属します。詳細は [assets/LICENSE](assets/LICENSE) と以下の注記を参照してください。 - **Clawd** キャラクターは [Anthropic](https://www.anthropic.com) の所有物です。このプロジェクトは非公式のファンプロジェクトであり、Anthropic との提携または承認を受けたものではありません。 - **Calico cat (三毛猫)** のアートワークは鹿鹿 ([@rullerzhou-afk](https://github.com/rullerzhou-afk)) によるものです。All rights reserved. - **Cloudling (云宝)** のアートワークは鹿鹿 ([@rullerzhou-afk](https://github.com/rullerzhou-afk)) によるものです。All rights reserved. Cloudling のビジュアル方針には OpenAI Codex ロゴへのオマージュが含まれています。Codex/OpenAI の標章は OpenAI に帰属し、このプロジェクトは OpenAI との提携または承認を受けたものではありません。 - **サードパーティのコントリビューション**: 著作権は各アーティストに帰属します。