Lydia Hallie shared a Claude Code demo in which snowfall responds to how much of the conversation’s context window has been used. She said she asked Claude to create the effect and that the mod hooks into turn.step, an event inside Claude Code. [1]
The background uses information from the session to change what it draws. Claude Code’s documentation describes the two parts involved: an event handler reads what is happening, and a rendering hook draws the result behind the conversation. [2, 3]
Testing a theme in one session
Anthropic publishes a theme-examples plugin for the desktop app. With it loaded, /custom-theme opens a picker with previews. /custom-theme list prints the available scene names. Its twenty animated scenes include choices designed for light or dark windows. [4]
Testing one without changing the project’s saved choice, requires /custom-theme <name> session. Omitting session applies the choice to the project; other open sessions without their own override adopt it on their next turn. /custom-theme off session clears the current session's selection. [4]
The plugin honors the operating system’s reduced-motion setting by holding a scene still. A missing animation can therefore be intentional. If a new session initially shows no theme, sending a message may resolve it: the README says the saved choice is applied when the first turn starts. [4]
Linking the background to an event
A turn can contain several requests to the model, especially when Claude calls tools. The turn.step event runs before each request. Anthropic documents how to access request token usage through this event and provides an example that reads usage from the finished response. Developers can use that information to update a visual indicator during the conversation. [3]
Developers asking Claude to create a theme should describe the relationship between the session data and the image. Hallie’s request tied snowfall to a filling context window. Her post names the event hook but does not supply a complete implementation or a formula for converting token counts into snowfall. [1]
The current backdrop interface uses $.theme.set to select a background and a Backdrop render hook to draw it. $.theme.clear removes it. Anthropic’s example sets the scene when a session starts, so the background does not depend on an earlier session remaining open. The terminal does not draw these backdrops. [2]
Checking the code behind the decoration
Mods run inside Claude Code with the user’s permissions. Their access includes files and network requests, along with prompts and tool calls. A theme packaged as a mod therefore deserves the same source review as another executable plugin. [5]
Anthropic says mods are not sandboxed, even when Bash commands are sandboxed. Use an author and marketplace you trust, and inspect what a downloaded mod does before loading it into a work session. The documentation also says a mod cannot restyle the permission prompt. [5]
When two mods both set a theme, a later set or clear call can remove the earlier background and colors. If a scene keeps disappearing, disabling the competing theme and trying a fresh local session in the Code tab may help. [2]
Sources
[1] Lydia Hallie on a context responsive Claude Code theme
[2] Anthropic documentation on drawing mod interfaces and backdrops
[3] Anthropic documentation on mod events and turn.step
[4] Anthropic theme examples plugin README
[5] Anthropic mods overview and permissions
Illustrative photograph of Rust code on a screen, taken in February 2026. This is not a screenshot of Claude Code or Hallie's theme. Slashme / Wikimedia Commons. CC0 1.0. Original photograph; no visual edits. Image source. Image license / permission.
Have a correction or a useful perspective?
Get in touch with the publication.


