gitwtfhub

wtf is rocky-desktop?

delrooow/rocky-desktop — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A 3D animated desktop companion that reacts live to your Claude Code or Codex sessions, showing status, permission requests, and general activity.

Mindmap

mindmap
  root((Rocky Desktop))
    What it does
      Animated desktop companion
      Reacts to coding sessions
      Shows agent status live
    Tech stack
      Electron
      Node.js
      HTML
    Use cases
      Session status at a glance
      On screen permission approval
      Offline voice responses
    Audience
      Developers
      Claude Code users
      Codex users
    Notable features
      Sleep and wake animation
      Local activity awareness
      Multiple voice modes

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

See at a glance whether an AI coding session is thinking, working, waiting for input, or has hit an error.

REASON 2

Approve or deny a coding agent's tool request from an on screen bubble instead of switching to the terminal.

REASON 3

Get a fun, animated companion that reflects general computer activity like video watching or browsing.

REASON 4

Use a fully offline neural voice to have the character speak back in character.

What's in the stack?

JavaScriptHTMLElectronNode.js

How it stacks up

delrooow/rocky-desktop100/rutgers-pbl-dining-2015a15n/a15n_old
Stars0
LanguageHTMLHTMLHTML
Last pushed2015-12-012016-06-18
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Prebuilt installers exist for macOS and Windows, the macOS build is unsigned so Gatekeeper needs a manual override.

Wtf does this do

Rocky Desktop is a 3D desktop companion app modeled on Rocky, a character from the novel and film Project Hail Mary. It sits on your screen and reacts in real time to what is happening in your Claude Code or Codex coding sessions, using their hook systems to know when you have sent a prompt, when the AI is thinking, when tools are actively running, and when a task finishes or fails. The character shows its state through small animated icons and matching movements. It perks up when you send a prompt, shows a busy meter while tools are running, celebrates with a hop when a task completes, and looks visibly worried if something goes wrong. When a session asks for permission to run a tool, an allow or deny bubble appears right above the character on screen, so a person can approve or reject it without switching over to the terminal window. If it is ignored for a couple of minutes, the request falls back to the normal terminal prompt. When no coding sessions are active, the character reflects general activity on the computer, such as watching video, doing design work, or browsing, based entirely on local detection with nothing sent over the network. It also has a sleep animation after a period of inactivity, and wakes back up when the user returns. Speech comes in three modes: musical sounds by default, an optional built in translated voice that runs fully offline using a small neural voice model, or a silent, text only mode.

Yoink these prompts

Prompt 1
Help me install Rocky Desktop from source and connect it to my Claude Code hooks.
Prompt 2
Show me how to point the PermissionRequest hook at Rocky's local server so I can approve tools on screen.
Prompt 3
Walk me through downloading the neural voice model so Rocky can speak in his translator voice.
Prompt 4
Explain how Rocky Desktop detects general computer activity like coding or browsing without sending data anywhere.

Frequently asked questions

wtf is rocky-desktop?

A 3D animated desktop companion that reacts live to your Claude Code or Codex sessions, showing status, permission requests, and general activity.

What language is rocky-desktop written in?

Mainly HTML. The stack also includes JavaScript, HTML, Electron.

How hard is rocky-desktop to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is rocky-desktop for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.