How ktumsh/claude-themes works
Claude Themes is a Claude Code plugin that renders animated SVG backdrops reflecting session usage, work state, and lifecycle events. The principal flow is plugin registration, theme selection, then rendering a scene from shared state and animation helpers; the plugin also supplies theme labels and preview thumbnails. The README documents the signals and scene behavior, while sampled code shows renderer inputs and shared helpers. Some plugin event wiring and renderer dispatch details are unsampled, so those relationships are not expanded beyond documented or indexed references.
Main entry points: register.ts Plugin registration · hooks 17 scene renderers · temas.ts Theme registry · comun.ts Session state
Components 10
Plugin runtime
- Plugin registration
hooks/register.ts - Theme registry
hooks/temas.ts - Theme thumbnails
hooks/miniaturas.ts - Theme settings
hooks
Scene rendering
- 17 scene renderers
hooks - Color generator
hooks/make-colors.js
Shared presentation
- Session state
hooks/comun.ts - Plugin types
types/index.d.ts - Theme labels
hooks/textos.ts
Other components
- Claude Code
Connections 9
- Claude Code → Plugin registration: loads plugin
README.md - Plugin registration → Theme registry: imports registry
hooks/register.ts - Plugin registration → Theme labels: imports labels
hooks/register.ts - Plugin registration → Theme thumbnails: imports thumbnails
hooks/register.ts - Theme registry → 17 scene renderers: registers themes
hooks/temas.ts - 17 scene renderers → Session state: uses state helpers
hooks/acuarela.ts - Session state → Plugin types: imports types
hooks/comun.ts - Claude Code → 17 scene renderers: provides session signals
README.md - 17 scene renderers → Claude Code: renders animated scenes
README.md