Project Page

Deppy: The Desktop Puppy

A Visual Studio Code extension featuring a beautifully animated puppy that responds to your rhythm, bringing clarity, calm, and character to your workspace.

Project

Open Source

Type

VS Code
Extension

Technology

TypeScript

Typescript FSM Analytics

Features

your IDE, alive

Deppy is an event-driven animated companion for VS Code. Built on a finite state machine, and a sandboxed WebView. It reacts to your diagnostics, build events, and coding session in real time

Character
Customization

Event
driven

Session
Intelligence

Analytics
Dashboard

Security
Features

Custom States & Characters

Drop a deppy.config.json into your workspace to swap character assets, add emotional states, or override transitions. Zero engine changes.

deppy.config.json — runtime state injection

{
  "states": {
    "sleeping":     { "uri": "sleeping.mp4"  },
    "working":      { "uri": "working.mp4"   },
    "excited":      { "uri": "excited.mp4"   },
    "concerned":    { "uri": "concerned.mp4" },
    // ↓ Drop-in custom state — zero engine changes
    "custom_focus": { "uri": "custom.mp4"    }
  },
  "transitions": {
    "sleeping_to_working":  { "uri": "wake_up.mp4"    },
    "working_to_excited":   { "uri": "celebrate.mp4"  },
    "working_to_concerned": { "uri": "worry.mp4"      },
    "excited_to_working":   { "uri": "settle.mp4"     }
  }
}

A Platform, Not a Plugin

No hardcoded states. No conditional spaghetti. Deppy's behaviour is entirely described by a config object, states and transitions are injected at WebView activation time via template tokens. Drop in a new state by adding a single JSON entry; the FSM engine requires zero changes.

State Transition Graph

Deppy is architected for extension. The core engine is decoupled from all content, swap characters, add triggers, register custom states, or build on the message protocol from another extension entirely.

Technology
stack

TypeScript

HTML5

GitHub

BalanceHub

Deppy: The Desktop Puppy

Features

Custom States & Characters

A Platform, Not a Plugin

Technologystack

Technology
stack