Clawd on Desk

Start a long task, walk away, and come back when the crab tells you it's done. Clawd thinks while you prompt, types while tools run, juggles when subagents pile up, pops a card when a tool needs your approval, and dozes off when you step away.

Features

• Live agent status: 12 animated states driven by agent hooks and logs, plus eye tracking, a sleep sequence, click reactions, and a mini mode that peeks from the screen edge
• Works with your tools: Claude Code, Codex, Copilot, Gemini, Cursor, opencode, Kiro, Qwen and 20+ more, each session tracked side by side
• Permission bubbles: Allow or Deny tool requests from a floating card or a global hotkey, or switch to auto-approve
• Sessions at a glance: a HUD next to the pet, a dashboard of every live session with one-click jump to its terminal, quota rings, and a private local recap
• Away from your desk: approve from Telegram or Feishu/Lark, get Slack notifications, or follow sessions on your phone with the read-only mobile PWA
• Make it yours: Clawd, Calico and Cloudling built in, official themes to download, Codex Pet imports, or a theme of your own
• Runs where you code: Windows (x64 and ARM64), macOS and Linux, plus Remote SSH and WSL, with the UI in 7 languages

Every feature in detail: docs/guides/features.md

Quick Start

Download the latest installer from GitHub Releases:

Platform	Download
Windows	Clawd-on-Desk-Setup-<version>-x64.exe or -arm64.exe
macOS	.dmg, or brew install --cask clawd-on-desk
Linux	.AppImage (in-app updates), or .deb with APT setup / migration (Homebrew also works on x86_64)

Launch Clawd and it starts reacting right away: Claude Code and Codex are connected on first launch. Every other agent is one click away in Settings → AI Coding Tools.

Only needed for contributing, testing unreleased code, or debugging integrations. Source installs download Electron and build tooling, so node_modules gets large.

# Clone the repo
git clone https://github.com/rullerzhou-afk/clawd-on-desk.git
cd clawd-on-desk

# Install dependencies
npm install

# Start Clawd (auto-registers Claude Code and Codex hooks on launch)
npm start

Prerequisites, Remote SSH, WSL, and macOS / Linux notes: setup guide

Supported Agents

Claude Code · Codex CLI · Copilot CLI · Gemini CLI · Antigravity CLI (agy) · Cursor Agent · CodeBuddy · WorkBuddy · Grok Build · Kiro CLI · KiroCrew · Kimi Code CLI (Kimi-CLI) · Qwen Code · ZCode · CodeWhale · opencode · MiMo Code · Pi · OMP · OpenClaw · Hermes Agent · Qoder · QoderWork · QwenWork (千问办公) · Reasonix CLI · DeepSeek Harness · TraeCode (Trae CN) · MiniMax Code

Claude Code and Codex CLI are set up on first launch; install any other integration from Settings → AI Coding Tools and Clawd keeps it synced. Other local tools can report through the custom HTTP agent endpoint. Per-agent details are in supported agents, and gaps such as agents without permission bubbles are in known limitations.

Themes

Clawd ships with Clawd (pixel crab), Calico (三花猫) and Cloudling (云宝). Hash Sage (哈希仙人) and Whale-chan (鲸鱼娘) are optional official themes in Settings → Theme, where you can also import a Codex Pet zip. To draw your own, run npm run create-theme -- my-theme and follow the theme creation guide. Which event plays which animation: state mapping.

Community tool: Live2Pet by @receyuki turns Live2D models into Clawd themes.

Guides

Guide	What it covers
Features	Every feature in detail
Setup guide	Source builds, agent setup, Windows / macOS / Linux notes
Permission handling	Ask every time, question prompts only, or auto-approve
Remote SSH	State and permission bubbles from agents on a remote server
Codex + WSL	What Clawd supports for Codex inside WSL
Remote approval	Telegram, plus Feishu / Lark and Slack notifications
Recap	Private local activity review
Custom HTTP agents	Connect a tool Clawd doesn't integrate with yet
Known limitations

Community

Join our Discord community to get help, share themes and desktop setups, or discuss ideas. English and Chinese are welcome. Please report bugs through GitHub Issues so we can track them.

Contributing

Clawd on Desk is a community-driven project. Bug reports, feature ideas, and pull requests are all welcome — open an issue to discuss or submit a PR directly. See CONTRIBUTING.md for how to run from source, add a translation, or integrate a new agent.

Maintainers

Contributors

Thanks to everyone who has helped make Clawd better:

Acknowledgments

• Clawd pixel art reference from clawd-tank by @marciogranzotto
• Shared on LINUX DO community

License

Source code is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

Artwork and bundled theme assets (including assets/ and themes/*/assets/) are NOT covered by AGPL-3.0. All rights reserved by their respective copyright holders. See assets/LICENSE and the notices below for details.

• Clawd character is the property of Anthropic. This is an unofficial fan project, not affiliated with or endorsed by Anthropic.
• Calico cat (三花猫) artwork by 鹿鹿 (@rullerzhou-afk). All rights reserved.
• Cloudling (云宝) artwork by 鹿鹿 (@rullerzhou-afk). All rights reserved. Cloudling's visual direction includes an homage to the OpenAI Codex logo; Codex/OpenAI marks remain the property of OpenAI, and this project is not affiliated with or endorsed by OpenAI.
• Hash Sage (哈希仙人) is distributed as an optional official theme from the rullerzhou-afk/clawd-themes repository. Its artwork is copyright 鹿鹿 (@rullerzhou-afk); see the theme package for its license and full attribution. It is not covered by this project's AGPL-3.0 source license.
• Whale-chan (鲸鱼娘) is distributed as an optional official theme from the rullerzhou-afk/clawd-themes repository. Rights in the original character design, setting and upstream materials remain with their creators; the theme credits ZipZipPipe and 上善无形 as named by Neko3000/deepseek-whalechan. New animation and effects by 鹿鹿 (@rullerzhou-afk) are licensed under CC BY-NC-SA 4.0; see the theme package for full terms. It is an unofficial, non-commercial fan work, not affiliated with or endorsed by DeepSeek, and it is not covered by this project's AGPL-3.0 source license.
• Third-party contributions: copyright retained by respective artists.

No cryptocurrency. This project has no token, coin, NFT, or airdrop, and is not affiliated with any cryptocurrency project.