wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2026 winget.ragerworks.com

Loading...
Install Clyde on Desk using Winget - wingetCollections
  1. Go back
  2. Packages
  3. Clyde on Desk
Clyde on Desk logo

Clyde on Desk clyde

claude-code desktop-pet
Use this command to install Clyde on Desk:
winget install --id=QingJ01.ClydeOnDesk -e

Clyde on Desk is a desktop companion designed to reflect the activities of your AI coding agent in real time, offering developers and AI enthusiasts a visual representation of their work. This tool provides insights into how agents operate, from initial prompts to task completion, enhancing workflow visibility.

Key Features:

  • Real-time Animations: Clyde displays 12 animated states corresponding to the AI's actions, such as thinking, typing, or celebrating successful tasks.
  • Interactive Capabilities: Users can drag Clyde anywhere on the screen, poke it for reactions, and access a context menu via right-click, offering options like session management and mode switching.
  • Mini Mode: Enables edge-snapping functionality where Clyde tucks behind the screen edge, peeking out on hover and displaying mini alerts or celebrations.

Audience & Benefit: Ideal for developers and AI enthusiasts using agents like Claude Code, Codex CLI, or Copilot CLI. Clyde enhances workflow efficiency by providing real-time feedback, simplifying permission management with visual cues, and offering a user-friendly interface that integrates seamlessly into their work environment.

README

Clyde on Desk

A lightweight desktop pet that mirrors your AI coding agent in real time

中文版

Clyde sits on your desktop and reflects what your AI coding agent is doing: thinking when you prompt, typing when tools run, juggling subagents, popping permission bubbles, celebrating on completion, and sleeping when you step away.

Works with Claude Code, Codex CLI, and Copilot CLI — all three can run simultaneously.

Quick Start

git clone https://github.com/QingJ01/Clyde.git
cd Clyde
npm install
npm start        # Tauri dev mode with hot-reload

Prerequisites — Node.js v18+, Rust stable, and Tauri prerequisites for your platform.

Agent setup — all zero-config:

  • Claude Code — hooks auto-registered on launch (command hooks + HTTP permission hook)
  • Codex CLI — log polling starts automatically (~/.codex/sessions/)
  • Copilot CLI — auto-configured when ~/.copilot exists

Features

Animations

12 animated states driven by real-time agent events:

Agent EventClyde DoesPreview
IdleFollows your cursor (eye tracking + body lean)
UserPromptSubmitThinking
PreToolUseTyping
Versions
0.1.6
Website
github.com
License
Last updated
4/24/2026
Download latest version
3+ sessions activeBuilding
1 subagentJuggling
2+ subagentsConducting
PostToolUseFailureError flash
Stop (task complete)Happy bounce
NotificationAlert jump
PreCompactSweeping
WorktreeCreateCarrying box
60s no activityYawn → doze → collapse → sleep

Interaction

  • Drag anywhere, anytime — Pointer Capture prevents fast-flick drops
  • Double-click for a poke reaction; 4 clicks for a flail
  • Right-click context menu — session list, DND, mini mode, size, language
  • System tray — resize (S/M/L), DND, mini mode, language, auto-start, quit

Mini Mode

Drag Clyde to the left or right screen edge (or right-click "Mini Mode"). Clyde hides behind the edge, peeks out on hover, and shows mini alerts/celebrations while tucked away.

Permission Bubbles

When Claude Code requests tool permissions, Clyde pops a floating card near the pet — allow, deny, or apply a suggestion rule (e.g. "Always allow Read"). Multiple requests stack upward from the pet. If you answer in the terminal first, the bubble auto-dismisses.

Clyde also tracks Claude's permission mode in real time. When the mode changes (e.g. switching to "Accept Edits" via /permissions), a brief notification appears near the pet:

ModeMeaning
DefaultTool calls require your approval
Accept EditsEdit operations auto-approved, others may still need approval
Bypass PermissionsNo approval bubbles will appear
PlanNo tool execution, planning only

Session Intelligence

  • Multi-session priority — the highest-priority state across all sessions wins
  • Subagent-aware — 1 subagent = juggling, 2+ = conducting
  • Terminal focus — right-click a session to jump to its terminal
  • Auto-cleanup — stale sessions removed after 10 min; working states demoted after 5 min
  • DND mode — silences all events; toggle via right-click or tray

Architecture

src-tauri/src/           Rust backend
├── lib.rs               App entry + Tauri commands
├── state_machine.rs     Multi-session state tracking + priority
├── http_server.rs       Axum HTTP (POST /state, /permission)
├── hooks.rs             Hook deployment + settings.json registration
├── permission.rs        Permission bubble windows
├── mini.rs              Edge snap, peek, parabolic jump
├── tick.rs              50ms cursor poll (eyes, sleep, peek)
├── tray.rs              System tray menu
├── windows.rs           Window bounds + hit-test math
├── focus.rs             Terminal focus by PID (Win/Mac/Linux)
├── codex_monitor.rs     Codex JSONL log polling
├── prefs.rs             Preferences persistence
└── i18n.rs              English / Chinese strings

src/windows/             Svelte 5 frontend (3 windows)
├── pet/                 SVG renderer
├── hit/                 Invisible click layer
└── bubble/              Permission card

hooks/                   JS hooks (embedded at compile time)
├── clyde-hook.js        Claude Code command hook
├── server-config.js     Port discovery
├── auto-start.js        Auto-launch on SessionStart
├── copilot-hook.js      Copilot CLI hook
└── install.js           Manual hook registration CLI

assets/svg/              35 animation frames

Tech Stack

LayerTechnologyWhy
Desktop frameworkTauri v2~5 MB bundle (vs 150 MB+ for Electron); native OS APIs (transparent windows, tray, global shortcuts); Rust backend calls with zero IPC serialization overhead
BackendRustNo GC, zero-cost abstractions; 50 ms timer + multi-session state machine in a single process with near-zero CPU; Mutex + Arc for thread safety by default
FrontendSvelte 5Compile-time, no virtual DOM — three windows total < 30 KB JS; $state / $props reactivity keeps SVG rendering logic minimal
HTTP serverAxumAsync web framework on Tokio; type-safe routing + extractors; shares the same Tokio runtime as Tauri — no extra thread pool
Build toolViteInstant HMR in dev; aggressive tree-shaking in production

Why this stack: Rust owns all state logic and system interaction, Svelte is a razor-thin rendering layer, and Tauri glues them into a < 10 MB cross-platform desktop app. No runtime interpreter (Node.js, Python, etc.) — cold start < 1 s, resident memory < 30 MB.

Known Limitations

LimitationDetails
Codex: no terminal focusJSONL polling doesn't carry terminal PID
Copilot: no permission bubbleCopilot's hook protocol only supports deny
HTTP server is unauthenticatedBinds 127.0.0.1 only; token auth planned
No auto-updateDownload new versions from GitHub Releases

Troubleshooting

macOS: "App is damaged and can't be opened"

This is macOS Gatekeeper blocking unsigned apps — the app is not actually damaged. Fix:

xattr -cr "/Applications/Clyde on Desk.app"
codesign --force --deep --sign - "/Applications/Clyde on Desk.app"

The first command clears the quarantine flag, the second adds an ad-hoc signature (required on Apple Silicon).

Permission bubbles not appearing

If Clyde's permission approval bubbles don't show when Claude Code requests tool permissions:

  1. In Claude Code, run /hooks and check that PermissionRequest has an [http] hook
  2. If missing or malformed, restart Clyde — it re-registers hooks on startup
  3. If still broken, run node hooks/install.js manually
  4. As a last resort, delete the PermissionRequest entry from ~/.claude/settings.json and restart Clyde

The correct format in ~/.claude/settings.json should look like:

"PermissionRequest": [
  {
    "matcher": "",
    "hooks": [
      { "type": "http", "url": "http://127.0.0.1:23333/permission", "timeout": 600 }
    ]
  }
]

> Permission bubbles only appear for tools that trigger Claude Code's PermissionRequest event.

Contributing

Issues, ideas, and PRs welcome — open an issue or submit a PR.

npm test             # cargo test (19 unit tests)

Contributors

<a href="https://github.com/QingJ01"><img src="https://github.com/QingJ01.png" width="50" /><b>QingJ01</b></a>Core Contributor
<a href="https://github.com/rullerzhou-afk"><img src="https://github.com/rullerzhou-afk.png" width="50" /><b>rullerzhou-afk</b></a>Original Project Author
<a href="https://github.com/PixelCookie-zyf"><img src="https://github.com/PixelCookie-zyf.png" width="50" /><b>PixelCookie-zyf</b></a>Original Contributor
<a href="https://github.com/yujiachen-y"><img src="https://github.com/yujiachen-y.png" width="50" /><b>yujiachen-y</b></a>Original Contributor
<a href="https://github.com/AooooooZzzz"><img src="https://github.com/AooooooZzzz.png" width="50" /><b>AooooooZzzz</b></a>Original Contributor
<a href="https://github.com/purefkh"><img src="https://github.com/purefkh.png" width="50" /><b>purefkh</b></a>Original Contributor


<a href="https://github.com/Tobeabellwether"><img src="https://github.com/Tobeabellwether.png" width="50" /><b>Tobeabellwether</b></a>Original Contributor
<a href="https://github.com/Jasonhonghh"><img src="https://github.com/Jasonhonghh.png" width="50" /><b>Jasonhonghh</b></a>Original Contributor
<a href="https://github.com/crashchen"><img src="https://github.com/crashchen.png" width="50" /><b>crashchen</b></a>Original Contributor
<a href="https://github.com/hongbigtou"><img src="https://github.com/hongbigtou.png" width="50" /><b>hongbigtou</b></a>Original Contributor
<a href="https://github.com/InTimmyDate"><img src="https://github.com/InTimmyDate.png" width="50" /><b>InTimmyDate</b></a>Original Contributor
<a href="https://github.com/NeizhiTouhu"><img src="https://github.com/NeizhiTouhu.png" width="50" /><b>NeizhiTouhu</b></a>Original Contributor

Acknowledgments

  • Forked from Clawd on Desk by @rullerzhou-afk — the original Clawd desktop pet project that inspired Clyde
  • Clyde pixel art reference from clawd-tank by @marciogranzotto
  • Thanks to the LINUX DO community for feedback and support
  • The Clyde character ("ClawdWizard") is a community creation. This project is not officially affiliated with or endorsed by Anthropic.

License

AGPL-3.0