dsh-bouncing-squares-example

The dsh-granular-settings plugin introduces three settings scopes—session, workspace, and global—but an abstract hierarchy is hard to internalize from documentation alone. This example plugin paints the three scopes on your screen in real time: a blue square bound to session, an amber square bound to workspace, and a green square bound to global. Every settings change becomes visible motion, color shift, or disappearance, making the boundaries between scopes immediately concrete.

Each scope registers the same four base keys (show, color, text, speed) and then exercises additional control types such as enum, multiselect, and number. You can open two sessions with different session colors, switch workspaces to see which squares follow the new context, and close every session to watch the green square keep bouncing—turning the scope model into instinct rather than theory.

It is aimed at developers learning the DeepSeek Harness plugin ecosystem who want a hands-on way to understand the granular-settings scope model, and at engineers who need a visual aid to explain to a team how the same setting key behaves differently across scopes. The plugin is a terminal example in itself; it has no downstream dependents and requires only dsh-granular-settings and dsh-event-relay upstream.