Skip to main content
plugin official · Anthropic

theme-examples — Claude Code plugin: themes and install

The theme-examples Claude Code plugin adds twenty animated backdrops to the chat window in the desktop app. Fireworks can run by command or when Claude says “merged”.

Apache-2.0 ★ 47,914 updated 2026-10-24

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin install theme-examples@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-official
Open on GitHub

What theme-examples does

The plugin adds twenty animated scenes behind the chat in the Claude Code desktop app. Each theme is made for a light or dark window, and can be assigned to a project or just one session.

Run /custom-theme list to see the available names. Use /custom-theme <name> session to set a theme for the current session, or /fireworks to trigger a short display. The automatic fireworks response to “merged” can be switched off with /fireworks auto off and restored with /fireworks auto on.

Displaying a theme requires a Claude Desktop version that renders a plugin backdrop behind the chat. Commands still respond on other versions, but the background may not appear; the project’s selected theme is still saved. The older desktop-themes plugin uses the same command names, so it needs to be disabled if installed.

What it helps with

  • browse the available animated backdrops
  • set a background for a project
  • choose a separate theme for one session
  • trigger fireworks by command or after “merged”

Example prompts for the agent

  • Show me the available themes with /custom-theme list.
  • Set lagoon for this session: /custom-theme lagoon session.
  • Trigger the fireworks with /fireworks.

How to install theme-examples

Plugin marketplace

/plugin install theme-examples@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-official

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about theme-examples

How do I install theme-examples in Claude Code?

Add the marketplace first with /plugin marketplace add anthropics/claude-plugins-official, then install the plugin using /plugin install theme-examples@claude-plugins-official.

What does theme-examples do?

It adds animated backgrounds to the Claude Code desktop chat window. A theme can belong to a project or a single session, and fireworks can run manually or after Claude says “merged”.

What does theme-examples need to work?

It needs a Claude Desktop version that renders plugin backdrops behind the chat.

Source text

theme-examples · Apache-2.0
# Theme examples

Twenty scenes to paint behind your Claude Code desktop window, light and dark.

Pick a scene for a project or for one session: a lagoon seen from above, a night reef, a koi pond, halftone sunrises, pen-plotter tides, paper gardens, a departure board, a starfield in braille dots and more. Each scene is drawn for a dark or for a light window and is animated. Its motion stops when your system asks for reduced motion; see Motion and comfort below.

This plugin is an example of what a plugin can do with the backdrop of the desktop window: read it, copy it, change it. If you have an earlier copy installed under the name `desktop-themes`, turn that one off first: both ask for the same two command names, and the themes you chose there do not carry over.

## Use

- `/custom-theme` shows a card with every theme, under the kind of window each is made for, with a preview button.
- `/custom-theme list` names all twenty, under the kind of window each is made for.
- `/custom-theme <name>` applies one to this project. Other open sessions of the project that have no choice of their own take it at their next turn. The name can be typed as the list prints it or as its title, in any case.
- `/custom-theme <name> session` applies it to this session only.
- `/custom-theme off` clears the project's theme. Other open sessions of the project that have no choice of their own clear at their next turn.
- `/custom-theme off session` clears this session alone. The project keeps its theme.
- `/fireworks` sets off a short show over the theme. One also goes off when Claude says "merged". One show runs at a time.
- `/fireworks auto off` turns off the show that goes off on "merged", and `/fireworks auto on` turns it on again. `/fireworks` itself still sets off a show.

## Light and dark windows

Each theme is made for a light or for a dark window; the card, the list and the answer to applying one say which. Eight of the twenty come in both kinds, and each of those names its twin. Whether the window follows a theme's kind is up to the app and depends on its version. Where the window keeps your own setting, pick a theme made for it, or change the setting under Settings, General, Appearance.

## What it needs

A version of Claude Desktop that draws a mod's backdrop behind the chat. Where no window has said that it draws one, every command still answers, and applying or previewing a theme, or typing `/fireworks`, adds that this window may not draw themes yet. A theme applied to the project is saved all the same.

## What it does not do

It looks at what Claude says for one word, "merged", and keeps none of it. At the start of each turn it checks the chosen theme and reads no text of your prompt. To tell which project a session in a git worktree belongs to, it asks Claude Code for the session's folder and repository, and looks from the project folder upward for an entry named `.git`; it opens no file. It writes a line to Claude Code's debug log saying how it found the project, and another whenever that changes, with no path in them; that log is kept when Claude Code runs with debugging on. If a background step fails, it adds a dim line with the error's own words to the transcript; that line is not sent to Claude. It sends nothing anywhere.

It stores the name of the theme you chose, per project, under the project folder's path. For a session in a linked git worktree that is the path of the matching folder in the repository's main working tree. For a session with a choice of its own it stores that name under the session's id, and keeps it for the 200 sessions that chose last. If you turn off the show that goes off on "merged", it stores that too. A session's own state also has its choice, the theme being previewed and two flags for the card; that state lives in memory and ends with the session. To tell sessions apart it reads one environment variable, the desktop app's id for the session, and nothing else from your environment.

## Motion and comfort

If your system asks for reduced motion, every scene rests in a composed picture and the bursts of a fireworks show stay hidden, on purpose; with no theme set, a show lays its own night sky over the window for its few seconds under that setting too. Where the app draws without GPU acceleration, it stops a scene's motion. Whether the app's own Motion setting stops it too depends on the version of the app; the mod reads no setting of the app.

## Known limits

Parts of a scene's artwork lie under the chat text, the sidebar and the session rail. How each scene looks beside them has not been measured.

In a new session and after /clear, no theme shows until you send a message. In a reopened archived session, none shows at first.

Whether a theme shows is asked of the session, not of each window on it, and at the moment the theme is set. A window that connects afterwards can draw the theme all the same, and so can a window that has not told Claude Code that it draws themes.

With another backdrop mod installed, a fireworks show or a preview ends on a bare window until that mod sets its backdrop again. A session has one theme at a time, so on newer versions of Claude Code clearing a theme clears whichever one stands, another plugin's too.

A session that runs elsewhere, such as over SSH or in WSL, shares no saved theme with the sessions on this machine.

A session in a linked git worktree takes the theme of its project, and a theme applied or cleared there is the project's. Where the project is a folder below the top of its repository and the session starts at the top of the worktree, the session takes the theme of the repository's top folder, and a theme applied there is saved for that top folder.

A session started inside a submodule keeps a theme of its own folder. A theme that an earlier version saved under a worktree's own path is not read.

A session works out which project it belongs to when it first needs to, and in most cases keeps the answer until the plugin reloads. If a file system error interrupts that, the session can keep to its own folder's theme until then. In a worktree session whose working folder has moved away from the project folder, a theme applied to the project can be saved under the worktree's own path, where it is not found once the two folders are the same again.

On a disk that ignores upper and lower case, a project opened under another capitalisation of its path may not show its theme.

Where the app stops a scene's motion for a cause other than your system's setting, three scenes, `koi-mosaic`, `dither-dunes` and `dither-dunes-night`, keep some details in view that their resting picture hides.

With the keyboard alone, Escape does not put the `/custom-theme` card away. Its close button does, and so does choosing a theme on it; closing it does not return focus to the prompt field.

## License

Apache License 2.0. The full text is in the LICENSE file beside this one.

© Anthropic · Apache-2.0 · anthropics/claude-plugins-official

Similar plugins

All plugins for Design →

From the same set175

The whole set →
hackathon This Claude Code skill plans a hackathon from a team backlog or from open-ended ideas. It asks about timing and attendees, then lays out projects and an event plan. CX Codex +1 ★ 47,914repo stars faq Builds a pinned FAQ for your team. It gathers recurring questions and generates clear, actionable answers. CX Codex +1 ★ 47,914repo stars climb climb is a Claude Code skill that places a person or team on an AI adoption path and suggests a next step. It starts when a champion wants to help someone progress. CX Codex +1 ★ 47,914repo stars repo-scout repo-scout — a subagent for Claude Code, Codex, and Cursor that gathers evidence from repository CI, settings, and git history. It generates structured reports with counts and metadata. CX Codex ★ 47,914repo stars champion-kit champion-kit — a plugin for Claude Code aids internal AI adoption. Runs hack days, schedules office hours, extracts repo patterns into skills, and builds an AI maturity report. ★ 47,914repo stars ralph-loop ralph-loop runs an iterative task loop in Claude Code, returning the original prompt to the agent whenever it attempts to exit. CX Codex +1 ★ 47,914repo stars help help explains the Ralph Loop technique, its iterative cycle, and the commands for starting or cancelling it. Useful when a task needs repeated passes toward a clear result. CX Codex +1 ★ 47,914repo stars cancel-ralph cancel-ralph cancels a running Ralph Loop: checks the state file, reads the iteration number and deletes it. Handy when a loop needs to stop. CX Codex +1 ★ 47,914repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open