Clawd

Clawd on Desk

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

Version Platform

Stars Mentioned in Awesome Claude Code

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 との提携または承認を受けたものではありません。 - **サードパーティのコントリビューション**: 著作権は各アーティストに帰属します。