claude-code-themes
Themes Library for Claude Code desktop app
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 20 Nov 2026. Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/PerspicaciousGuy/ClaudeCodeThemes with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/PerspicaciousGuy/ClaudeCodeThemes'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/perspicaciousguy--claudecodethemes)HTML
<a href="/listings/perspicaciousguy--claudecodethemes"><img src="/api/listings/perspicaciousguy--claudecodethemes/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
You need the Claude Code desktop app. Themes draw there (and in the mobile app); the terminal and editor extensions don't draw themes.
There are two ways to install: **the whole library as one plugin** (recommended), or **one theme at a time**.
The whole library: `theme-library`
One plugin holds every theme and a switcher, so you install once and change themes whenever you like.
In the desktop app: click **+** next to the prompt box, then **Plugins**, choose **Add marketplace** and enter `PerspicaciousGuy/ClaudeCodeThemes`, then **Add plugin** and pick `theme-library`.
Or at the prompt of a terminal Claude Code session:
/plugin install theme-library --marketplace PerspicaciousGuy/ClaudeCodeThemes
Or from a shell:
claude plugin install theme-library --marketplace PerspicaciousGuy/ClaudeCodeThemes
Then, in a session:
| Command | What it does | | --- | --- | | `/ccthemes` | Opens a card of themes you can filter (dark, light, pixel, vector, still, clock): Apply, Preview (20 seconds, not kept) and No theme | | `/ccthemes <name>` | Applies a theme, such as `/ccthemes neon-rain` (a unique start of the name works) | | `/ccthemes dark`, `light`, `pixel`, `vector`, `still`, `clock` | Opens the card with that filter on | | `/ccthemes find <words>` | Searches names, tags and descriptions, such as `find beach` | | `/ccthemes widgets [on or off]` | Lays four widgets over your theme: context window fill, 5-hour and 7-day limits used, the time until each limit resets and session cost, in a shape and look that match the theme (19 in all, from tombstones to scrolls, taped notes and brass portholes: paper, neon, pixel, blueprint, deco, frost, wood, ink, riso, terminal, amber, pastel, spooky, reef, dune, ice, festive, porthole and leaf). Off by default; works over any theme with a scene | | `/ccthemes widgets left`, `right` or `both` | Moves the widgets to the left, the right (the default) or one column on each edge | | `/ccthemes widgets look neon` | Uses one look on every theme instead of matching each; `look auto` goes back. The looks are paper, neon, pixel, blueprint, deco, frost, wood, ink, riso, terminal, amber, pastel, spooky, reef, dune, ice, festive, porthole and leaf | | `/ccthemes mascot [on, tile, walk or off]` | Adds a small orange critter, in the spirit of the Claude Code mascot. It rests, works at a laptop while Claude does, hops when a turn ends, looks worried when context is nearly full and naps when a limit is hit. `tile` puts it beside the widgets, `walk` lets it stroll along the bottom of the scene, `on` does both. It wears a hat that suits the theme (pirate, witch, shades, straw hat, beanie and more) | | `/ccthemes auto` | Day and night: themes with a twin switch between their light and dark halves by your clock | | `/ccthemes list` | Names every theme | | `/ccthemes random` / `next` / `prev` | Applies a random, the next or the previous theme, optionally within a filter | | `/ccthemes off` | Clears the theme |
The theme you apply is kept for later sessions, in every project. In a new session no theme shows until you send a first message.
One theme at a time
Install a single theme instead of the library:
/plugin install beacon-cove --marketplace PerspicaciousGuy/ClaudeCodeThemes
claude plugin install beacon-cove --marketplace PerspicaciousGuy/ClaudeCodeThemes
Replace `beacon-cove` with any theme's name from the table above. The first time, Claude Code asks `Add marketplace?`: answer `y`, then choose a scope (the user scope applies to every session). A theme installed from a terminal at the user scope also loads in your desktop app's local sessions. The theme applies at the start of a session: if it doesn't show, start a new session.
A session has one theme, so if two single themes (or one and the library) are installed they overwrite each other. Use one route or the other, or switch with:
claude plugin disable hearth claude plugin enable beacon-cove
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 436 lines
- {
- "name": "claude-code-themes",
- "owner": {
- "name": "Perspicacious Guy"
- },
- "metadata": {
- "description": "Themes for the Claude Code desktop app: colors and animated backdrops."
- },
- "plugins": [
- {
- "name": "theme-library",
- "source": "./theme-library",
- "description": "Every theme in this library in one plugin, with /ccthemes to switch between them: a card you can filter by mode and style, search, preview and apply, a day and night mode that swaps twin themes by your clock, random, next, prev and off. Install this instead of several single themes."
- },
- {
- "name": "abyss-lantern",
- "source": "./themes/abyss-lantern",
- "description": "The deep sea: sun shafts fading into the dark, glowing jellyfish, swaying kelp, bubbles and a passing school of fish. Dark."
- },
- {
- "name": "arcade-hall",
- "source": "./themes/arcade-hall",
- "description": "A pixel-art arcade at night: rows of cabinets playing their own little games, neon tubes and a patterned carpet. Dark."
- },
- {
- "name": "art-deco",
- "source": "./themes/art-deco",
- "description": "A 1920s deco poster: a gold sunburst over deep navy, stepped towers with gold-lined windows, concentric fan arcs and a shimmer of light crossing the gold. Dark."
- },
- {
- "name": "aurora-field",
- "source": "./themes/aurora-field",
- "description": "Northern lights over a frozen lake ringed by pines, with twinkling stars and the odd shooting star. Dark."
- },
- {
- "name": "autumn-forest",
- "source": "./themes/autumn-forest",
- "description": "A forest in autumn at golden dusk: trees in red, orange and gold, leaves spiraling down, slanting light and a carpet of fallen leaves. Dark."
- },
- {
- "name": "bamboo-grove",
- "source": "./themes/bamboo-grove",
- "description": "A bamboo grove in morning mist: tall green stalks in layers fading into haze, leaves swaying, slow light shafts and a few leaves falling. Light."
- },
- {
- "name": "beacon-cove",
- "source": "./themes/beacon-cove",
- "description": "An animated pixel-art theme that follows your clock: a lighthouse cape and sea from night through dawn, day and dusk, with a moving sun and moon, drifting clouds, a small boat and fireflies."
- },
- {
- "name": "blueprint",
- "source": "./themes/blueprint",
- "description": "An architect's blueprint: a fine grid on deep blue paper, with a gear, a house elevation, a beam section and a compass drawing that trace themselves in white line. Dark."
- },
- {
- "name": "campfire",
- "source": "./themes/campfire",
- "description": "A night camp whose fire follows your 5-hour usage window and whose woodpile follows your context window: a roaring fire when plenty is left, embers when you are near the limit. A live theme. Dark."
- },
- {
- "name": "cassette-futurism",
- "source": "./themes/cassette-futurism",
- "description": "A 1980s vision of the future: an amber monochrome console with a sweeping radar, a spectrum, scrolling data, turning cassette reels, blinking lights and scanlines. Dark."
- },
- {
- "name": "circuit-board",
- "source": "./themes/circuit-board",
- "description": "A green circuit board: traces between pads and chips, bright pulses of light running along them and small LEDs blinking on their own beats. Dark."
- },
- {
- "name": "circuit-board-calm",
- "source": "./themes/circuit-board-calm",
- "description": "A calm version of circuit-board: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark"
- },
- {
- "name": "cloud-sea",
- "source": "./themes/cloud-sea",
- "description": "Sunrise above a sea of clouds: rolling banks of cloud drifting between dark peaks, a low sun, birds and a pastel sky from peach to blue. Light."
- },
- {
- "name": "code-rain",
- "source": "./themes/code-rain",
- "description": "Columns of falling glyphs in phosphor green, bright at the head and fading behind, dimmer under the chat. Dark."
- },
- {
- "name": "code-rain-calm",
- "source": "./themes/code-rain-calm",
- "description": "A calm version of code-rain: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark"
- },
- {
- "name": "colorblind-safe-dark",
- "source": "./themes/colorblind-safe-dark",
- "description": "A dark theme whose colors stay apart for red-green and blue-yellow color blindness: blue and orange for added and removed, and a different lightness for each status. Colors only."
- },
- {
- "name": "colorblind-safe-light",
- "source": "./themes/colorblind-safe-light",
- "description": "A light theme whose colors stay apart for red-green and blue-yellow color blindness: blue and orange for added and removed, and a different lightness for each status. Colors only."
- },
- {
- "name": "constellations",
- "source": "./themes/constellations",
- "description": "A star map: rings and meridians of a celestial chart on deep blue, with constellations that draw themselves star to star, hold, then fade, and shooting stars. Dark."
- },
- {
- "name": "contour-map",
- "source": "./themes/contour-map",
- "description": "A topographic survey on warm paper: elevation lines draw themselves one height at a time around a flat basin. Light."
- },
- {
- "name": "contour-map-night",
- "source": "./themes/contour-map-night",
- "description": "The topographic survey in pale ink on blue-black paper, with the contours drawing themselves. Dark."
- },
- {
- "name": "coral-reef",
- "source": "./themes/coral-reef",
- "description": "A sunlit coral reef: caustic light rippling over branching corals and sea fans, schools of bright fish, a clownfish in an anemone, a turtle gliding by and rising bubbles. Dark."
- },
- {
- "name": "coral-reef-calm",
- "source": "./themes/coral-reef-calm",
- "description": "A calm version of coral-reef: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark"
- },
- {
- "name": "desert-night",
- "source": "./themes/desert-night",
- "description": "A desert after dark: stars and a cold moon over blue-violet mesas, saguaros in silhouette, a campfire with sparks and an owl. Dark."
- },
- {
- "name": "desert-noon",
- "source": "./themes/desert-noon",
- "description": "A bright desert at midday: red mesas, a pale sun, saguaros, heat shimmer, drifting dust and a tumbleweed. Light."
- },
- {
- "name": "fog-valley",
- "source": "./themes/fog-valley",
- "description": "A misty mountain morning: blue ridges with fog drifting between them, low sun rays, a flock of birds and a far balloon. Light."
- },
- {
- "name": "fog-valley-night",
- "source": "./themes/fog-valley-night",
- "description": "A misty mountain night: a moon over deep-blue ridges, pale fog drifting between them, fireflies in the pines and a sky lantern rising. Dark."
- },
- {
- "name": "forest-floor",
- "source": "./themes/forest-floor",
- "description": "Moss, bark and fern: a green-brown dark theme and a pale lichen light one, with a fern-green accent. Colors only."
- },
- {
- "name": "forest-trail",
- "source": "./themes/forest-trail",
- "description": "A pixel-art forest trail on a bright morning: sunbeams through layered trees, a winding dirt path, drifting mist, butterflies and falling leaves. Light."
- },
- {
- "name": "graphite",
- "source": "./themes/graphite",
- "description": "Neutral graphite grays with one steel-blue accent. Quiet and tool-like, light and dark, colors only."
- },
- {
- "name": "greenhouse-rain",
- "source": "./themes/greenhouse-rain",
- "description": "A glass greenhouse at dusk in the rain: streaks and drops running down the panes, big leaves and ferns swaying inside, warm hanging lamps and a drifting mist. Dark."
- },
- {
- "name": "halftone-harbor",
- "source": "./themes/halftone-harbor",
- "description": "A two-ink halftone print of a harbor at sunset: a coral sun and its wake, blue water, a headland with a lighthouse, two boats. Light."
- },
- {
- "name": "halftone-harbor-night",
- "source": "./themes/halftone-harbor-night",
- "description": "The halftone harbor printed on night-blue stock: an ember sun and pale-blue water in breathing dots. Dark."
- },
- {
- "name": "halloween-night",
- "source": "./themes/halloween-night",
- "description": "A haunted hill on Halloween: a huge orange moon, a crooked manor with flickering windows, bats, drifting ghosts, glowing jack-o'-lanterns and fog among the gravestones. Dark. A vector companion to haunted-manor."
- },
- {
- "name": "harvest-moon",
- "source": "./themes/harvest-moon",
- "description": "A huge orange moon over a wheat field: wheat swaying in waves, hay bales and a barn in silhouette, crows crossing the moon and stars coming out. Dark."
- },
- {
- "name": "haunted-manor",
- "source": "./themes/haunted-manor",
- "description": "A pixel-art haunted manor under a huge moon: flickering windows, bats crossing the sky, a bare tree, drifting ground fog and an iron fence. Dark."
- },
- {
- "name": "hearth",
- "source": "./themes/hearth",
- "description": "A warm theme: espresso and cream surfaces, terracotta accents, and a slow dusk backdrop with embers drifting up."
- },
- {
- "name": "high-contrast-dark",
- "source": "./themes/high-contrast-dark",
- "description": "Pure black and white with bright, saturated colors: text well past the AA bar on every surface, and strong borders. Dark, colors only."
- },
- {
- "name": "high-contrast-light",
- "source": "./themes/high-contrast-light",
- "description": "Black on white with deep, saturated colors: text well past the AA bar on every surface, and strong borders. Light, colors only."
- },
- {
- "name": "ink-wash",
- "source": "./themes/ink-wash",
- "description": "A sumi-e painting on rice paper: mountains in grey washes fading into mist, a pine branch, a lone boat, birds crossing and a red seal. Light."
- },
- {
- "name": "isometric-room",
- "source": "./themes/isometric-room",
- "description": "A small isometric room at night: a desk with a glowing monitor and lamp, a plant, a bookshelf, a window onto a moonlit sky and a cat asleep on the rug. Dark."
- },
- {
- "name": "koi-pond",
- "source": "./themes/koi-pond",
- "description": "A koi pond seen from above at dusk: orange and white koi gliding in slow loops, lily pads with pink flowers, ripples spreading and petals drifting on dark water. Dark."
- },
- {
- "name": "lantern-festival",
- "source": "./themes/lantern-festival",
- "description": "A lantern festival on a lake at night: paper lanterns rising into a starry sky, their warm light shimmering on the water, a pagoda and hills in silhouette. Dark."
- },
- {
- "name": "low-orbit",
- "source": "./themes/low-orbit",
- "description": "A pixel-art view of space: a ringed gas giant, a small moon, a nebula, parallax stars, a passing ship and shooting stars. Dark."
- },
- {
- "name": "meadow-hours",
- "source": "./themes/meadow-hours",
- "description": "A rolling meadow that follows your clock: dawn, day, dusk and night, with a moving sun and moon, butterflies by day and fireflies after dark. Dark."
- },
- {
- "name": "midnight-ink",
- "source": "./themes/midnight-ink",
- "description": "Blue-black ink with pale paper-white text and a periwinkle accent. Dark, colors only."
- },
- {
- "name": "moonlit-shore",
- "source": "./themes/moonlit-shore",
- "description": "A pixel-art beach at night: a moon and its glitter on the sea, stars, a campfire with sparks, a lantern boat and a crab. Dark."
- },
- {
- "name": "neon-rain",
- "source": "./themes/neon-rain",
- "description": "A pixel-art city at night in the rain: towers with lit windows, buzzing neon signs, a wet street and a passing car. Dark."
- },
- {
- "name": "neon-rain-calm",
- "source": "./themes/neon-rain-calm",
- "description": "A calm version of neon-rain: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark"
- },
- {
- "name": "new-year-fireworks",
- "source": "./themes/new-year-fireworks",
- "description": "New Year's night over a city: rockets climbing and bursting in rings of colored sparks that fall as they fade, lit windows and stars through the smoke. Dark."
- },
- {
- "name": "new-year-fireworks-calm",
- "source": "./themes/new-year-fireworks-calm",
- "description": "A calm version of new-year-fireworks: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark"
- },
- {
- "name": "night-market",
- "source": "./themes/night-market",
- "description": "A pixel-art night market: strings of paper lanterns swinging over a lane, two glowing food stalls with rising steam, puddles that carry the light and a cat on a crate. Dark."
- },
- {
- "name": "night-train",
- "source": "./themes/night-train",
- "description": "A night run seen from a carriage window: hills, town lights and telegraph poles sliding past under a thin moon. Dark."
- },
- {
- "name": "origami-bay",
- "source": "./themes/origami-bay",
- "description": "A bay made of folded paper: layered paper waves that drift, an origami sailboat bobbing, folded cranes flying across a paper sun and clouds. Light."
- },
- {
- "name": "oscilloscope",
- "source": "./themes/oscilloscope",
- "description": "An oscilloscope screen: a glowing green graticule with a sine, a two-tone, a square and a triangle wave scrolling across and a cursor sweeping the display. Dark."
- },
- {
- "name": "oscilloscope-calm",
- "source": "./themes/oscilloscope-calm",
- "description": "A calm version of oscilloscope: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark"
- },
- {
- "name": "paperback",
- "source": "./themes/paperback",
- "description": "A well-read paperback: cream pages, brown-black ink and an ink-blue accent. Light, colors only."
- },
- {
- "name": "papercut-peaks",
- "source": "./themes/papercut-peaks",
- "description": "Five sheets of colored paper layered into mountains, each casting a soft shadow, with paper clouds and birds. Light."
- },
- {
- "name": "papercut-peaks-night",
- "source": "./themes/papercut-peaks-night",
- "description": "The paper-cut mountains in deep indigo under a paper moon and cut-out stars. Dark."
- },
- {
- "name": "pirate-cove",
- "source": "./themes/pirate-cove",
- "description": "A pirate galleon in a sunny cove: a skull flag waving, gulls overhead, a far sail on the horizon and a treasure chest on a palm beach. Light."
- },
- {
- "name": "pirate-cove-night",
- "source": "./themes/pirate-cove-night",
- "description": "A pirate galleon under a full moon: a skull flag waving, lantern light at the stern, a far ship on the horizon and a treasure chest glowing on a palm islet. Dark."
- },
- {
- "name": "pixel-cafe",
- "source": "./themes/pixel-cafe",
- "description": "A pixel-art cafe on a rainy night: rain running down a big window over blurred city lights, warm pendant lamps, a steaming cup on the counter and a cat asleep on the sill. Dark."
- },
- {
- "name": "rainy-window",
- "source": "./themes/rainy-window",
- "description": "A night city seen through a rain-streaked window: soft bokeh lights, drops sliding down the glass, a warm lamp and a steaming mug. Dark."
- },
- {
- "name": "reading-room",
- "source": "./themes/reading-room",
- "description": "A cozy library at night: tall shelves of books, a floor lamp with dust turning in its light, a candle, a cup of tea and a sleeping cat. Dark."
- },
- {
- "name": "real-sky",
- "source": "./themes/real-sky",
- "description": "A lakeside view under the sky outside right now: the sun crosses from sunrise to sunset by your clock, and at night the moon crosses in its real phase for today, with stars and its reflection in the lake. A live theme. Dark."
- },
- {
- "name": "retro-grid",
- "source": "./themes/retro-grid",
- "description": "A neon horizon: a slatted sun, wireframe mountains and a perspective grid that rolls toward you. Dark."
- },
- {
- "name": "risograph",
- "source": "./themes/risograph",
- "description": "A risograph print: fluorescent pink, teal and yellow shapes overprinting on warm paper with halftone dots and slight misregistration, drifting as if the ink were still wet. Light."
- },
- {
- "name": "rooftop-garden",
- "source": "./themes/rooftop-garden",
- "description": "A pixel-art rooftop at golden hour: a pastel skyline, planters of sunflowers and tomatoes, string lights, birds on a wire and a kite. Light."
- },
- {
- "name": "rooftop-garden-night",
- "source": "./themes/rooftop-garden-night",
- "description": "A pixel-art rooftop after dark: a moon and stars over a skyline of lit windows, glowing string lights, fireflies and a lantern. Dark."
- },
- {
- "name": "sakura-drift",
- "source": "./themes/sakura-drift",
- "description": "A spring dusk of pastel sky, misty hills and a blossoming tree, with petals drifting down. Light and dark."
- },
- {
- "name": "snow-cabin",
- "source": "./themes/snow-cabin",
- "description": "A winter night: a log cabin with a lit window, smoke curling from the chimney, snowy pines and snow falling in three layers. Dark."
- },
- {
- "name": "snow-cabin-day",
- "source": "./themes/snow-cabin-day",
- "description": "A winter noon: a pale blue sky and low sun, white hills, a log cabin with smoke from its chimney and snow falling in three layers. Light."
- },
- {
- "name": "snow-station",
- "source": "./themes/snow-station",
- "description": "A pixel-art train station in a night snowfall: snow drifting past warm lamps, a slow night train on the far track, a glowing clock on the gable and a bench under the canopy. Dark."
- },
- {
- "name": "spooky-hollow",
- "source": "./themes/spooky-hollow",
- "description": "A haunted graveyard under a full moon: a dead tree with a swinging green lantern and a blinking owl, tilted tombstones, drifting ghosts and wisps, bats crossing the sky, a crooked house with a flickering window and a glowing pumpkin. Dark."
- },
- {
- "name": "spring-rain",
- "source": "./themes/spring-rain",
- "description": "A soft spring rain over pale green hills: blossoming trees shedding petals, rain streaking through, puddles rippling under a pastel sky. Light."
- },
- {
- "name": "stained-glass",
- "source": "./themes/stained-glass",
- "description": "A cathedral window at night: four arched lancets of jewel-colored panes in dark lead, a slowly turning rose window and light drifting across the glass. Dark."
- },
- {
- "name": "summer-fireflies",
- "source": "./themes/summer-fireflies",
- "description": "A meadow at dusk: fireflies blinking and drifting over swaying grass, a thin moon, first stars and the last orange glow on the horizon. Dark."
- },
- {
- "name": "sunny-shore",
- "source": "./themes/sunny-shore",
- "description": "A pixel-art beach on a bright day: a pulsing sun, drifting clouds, a sparkling sea, rolling foam, palms, gulls and a crab. Light."
- },
- {
- "name": "tide",
- "source": "./themes/tide",
- "description": "A beach at dusk whose tide follows your 5-hour usage window: high water while plenty is left, then the sea draws back and leaves wet sand, rocks, tide pools and a stranded boat. A live theme. Dark."
- },
- {
- "name": "tide-pool",
- "source": "./themes/tide-pool",
- "description": "Looking straight down into a rock pool: breathing anemones, starfish, rippling light, drops making rings and small fish. Dark."
- },
- {
- "name": "torch-dungeon",
- "source": "./themes/torch-dungeon",
- "description": "A pixel-art dungeon wall: two flickering torches, a dark doorway with watching eyes, bats, a hopping slime and a treasure chest. Dark."
- },
- {
- "name": "ukiyo-e-wave",
- "source": "./themes/ukiyo-e-wave",
- "description": "A Japanese woodblock print: a great wave curling over scale-pattern swells, boats riding the water, a red sun and a snow-capped mountain on cream paper. Light."
- },
- {
- "name": "weather-mood",
- "source": "./themes/weather-mood",
- "description": "A lighthouse on a rocky headland whose weather follows Claude: a clear calm night while it is idle, clouds and rain while it works (harder as the context window fills) and a flash of lightning when a tool call fails. A live theme. Dark."
- },
- {
- "name": "weekly-sky",
- "source": "./themes/weekly-sky",
- "description": "A lakeside cabin under a sky that crosses a whole day as your 7-day usage window is used: sunrise at the start of the week, noon in the middle, sunset as you near the limit and night when you reach it. A live theme. Dark."
- },
- {
- "name": "winter-lights",
- "source": "./themes/winter-lights",
- "description": "A snowy night dressed for the holidays: strings of colored lights twinkling in three phases, lit fir trees and a cottage, falling snow and a bright moon. Dark."
- }
- ]
- }
README.md · README · 222 lines
- # Claude Code Themes
- Themes for the **Claude Code desktop app**: custom colors, and animated backdrops that play behind your conversation. Each theme is a small plugin you can install in one step, and this repository is also a kit for making your own.
- ## Themes
- <!-- previews:start -->
- | | | |
- | --- | --- | --- |
- [<img src="docs/previews/abyss-lantern.svg" width="300" alt="abyss-lantern"><br>**abyss-lantern**](themes/abyss-lantern) | [<img src="docs/previews/arcade-hall.svg" width="300" alt="arcade-hall"><br>**arcade-hall**](themes/arcade-hall) | [<img src="docs/previews/art-deco.svg" width="300" alt="art-deco"><br>**art-deco**](themes/art-deco)
- [<img src="docs/previews/aurora-field.svg" width="300" alt="aurora-field"><br>**aurora-field**](themes/aurora-field) | [<img src="docs/previews/autumn-forest.svg" width="300" alt="autumn-forest"><br>**autumn-forest**](themes/autumn-forest) | [<img src="docs/previews/bamboo-grove.svg" width="300" alt="bamboo-grove"><br>**bamboo-grove**](themes/bamboo-grove)
- [<img src="docs/previews/beacon-cove.svg" width="300" alt="beacon-cove"><br>**beacon-cove**](themes/beacon-cove) | [<img src="docs/previews/blueprint.svg" width="300" alt="blueprint"><br>**blueprint**](themes/blueprint) | [<img src="docs/previews/campfire.svg" width="300" alt="campfire"><br>**campfire**](themes/campfire)
- [<img src="docs/previews/cassette-futurism.svg" width="300" alt="cassette-futurism"><br>**cassette-futurism**](themes/cassette-futurism) | [<img src="docs/previews/circuit-board.svg" width="300" alt="circuit-board"><br>**circuit-board**](themes/circuit-board) | [<img src="docs/previews/circuit-board-calm.svg" width="300" alt="circuit-board-calm"><br>**circuit-board-calm**](themes/circuit-board-calm)
- [<img src="docs/previews/cloud-sea.svg" width="300" alt="cloud-sea"><br>**cloud-sea**](themes/cloud-sea) | [<img src="docs/previews/code-rain.svg" width="300" alt="code-rain"><br>**code-rain**](themes/code-rain) | [<img src="docs/previews/code-rain-calm.svg" width="300" alt="code-rain-calm"><br>**code-rain-calm**](themes/code-rain-calm)
- [<img src="docs/previews/colorblind-safe-dark.png" width="300" alt="colorblind-safe-dark"><br>**colorblind-safe-dark**](themes/colorblind-safe-dark) | [<img src="docs/previews/colorblind-safe-light.png" width="300" alt="colorblind-safe-light"><br>**colorblind-safe-light**](themes/colorblind-safe-light) | [<img src="docs/previews/constellations.svg" width="300" alt="constellations"><br>**constellations**](themes/constellations)
- [<img src="docs/previews/contour-map.svg" width="300" alt="contour-map"><br>**contour-map**](themes/contour-map) | [<img src="docs/previews/contour-map-night.svg" width="300" alt="contour-map-night"><br>**contour-map-night**](themes/contour-map-night) | [<img src="docs/previews/coral-reef.svg" width="300" alt="coral-reef"><br>**coral-reef**](themes/coral-reef)
- [<img src="docs/previews/coral-reef-calm.svg" width="300" alt="coral-reef-calm"><br>**coral-reef-calm**](themes/coral-reef-calm) | [<img src="docs/previews/desert-night.svg" width="300" alt="desert-night"><br>**desert-night**](themes/desert-night) | [<img src="docs/previews/desert-noon.svg" width="300" alt="desert-noon"><br>**desert-noon**](themes/desert-noon)
- [<img src="docs/previews/fog-valley.svg" width="300" alt="fog-valley"><br>**fog-valley**](themes/fog-valley) | [<img src="docs/previews/fog-valley-night.svg" width="300" alt="fog-valley-night"><br>**fog-valley-night**](themes/fog-valley-night) | [<img src="docs/previews/forest-floor.png" width="300" alt="forest-floor"><br>**forest-floor**](themes/forest-floor)
- [<img src="docs/previews/forest-trail.svg" width="300" alt="forest-trail"><br>**forest-trail**](themes/forest-trail) | [<img src="docs/previews/graphite.png" width="300" alt="graphite"><br>**graphite**](themes/graphite) | [<img src="docs/previews/greenhouse-rain.svg" width="300" alt="greenhouse-rain"><br>**greenhouse-rain**](themes/greenhouse-rain)
- [<img src="docs/previews/halftone-harbor.svg" width="300" alt="halftone-harbor"><br>**halftone-harbor**](themes/halftone-harbor) | [<img src="docs/previews/halftone-harbor-night.svg" width="300" alt="halftone-harbor-night"><br>**halftone-harbor-night**](themes/halftone-harbor-night) | [<img src="docs/previews/halloween-night.svg" width="300" alt="halloween-night"><br>**halloween-night**](themes/halloween-night)
- [<img src="docs/previews/harvest-moon.svg" width="300" alt="harvest-moon"><br>**harvest-moon**](themes/harvest-moon) | [<img src="docs/previews/haunted-manor.svg" width="300" alt="haunted-manor"><br>**haunted-manor**](themes/haunted-manor) | [<img src="docs/previews/hearth.svg" width="300" alt="hearth"><br>**hearth**](themes/hearth)
- [<img src="docs/previews/high-contrast-dark.png" width="300" alt="high-contrast-dark"><br>**high-contrast-dark**](themes/high-contrast-dark) | [<img src="docs/previews/high-contrast-light.png" width="300" alt="high-contrast-light"><br>**high-contrast-light**](themes/high-contrast-light) | [<img src="docs/previews/ink-wash.svg" width="300" alt="ink-wash"><br>**ink-wash**](themes/ink-wash)
- [<img src="docs/previews/isometric-room.svg" width="300" alt="isometric-room"><br>**isometric-room**](themes/isometric-room) | [<img src="docs/previews/koi-pond.svg" width="300" alt="koi-pond"><br>**koi-pond**](themes/koi-pond) | [<img src="docs/previews/lantern-festival.svg" width="300" alt="lantern-festival"><br>**lantern-festival**](themes/lantern-festival)
- [<img src="docs/previews/low-orbit.svg" width="300" alt="low-orbit"><br>**low-orbit**](themes/low-orbit) | [<img src="docs/previews/meadow-hours.svg" width="300" alt="meadow-hours"><br>**meadow-hours**](themes/meadow-hours) | [<img src="docs/previews/midnight-ink.png" width="300" alt="midnight-ink"><br>**midnight-ink**](themes/midnight-ink)
- [<img src="docs/previews/moonlit-shore.svg" width="300" alt="moonlit-shore"><br>**moonlit-shore**](themes/moonlit-shore) | [<img src="docs/previews/neon-rain.svg" width="300" alt="neon-rain"><br>**neon-rain**](themes/neon-rain) | [<img src="docs/previews/neon-rain-calm.svg" width="300" alt="neon-rain-calm"><br>**neon-rain-calm**](themes/neon-rain-calm)
- [<img src="docs/previews/new-year-fireworks.svg" width="300" alt="new-year-fireworks"><br>**new-year-fireworks**](themes/new-year-fireworks) | [<img src="docs/previews/new-year-fireworks-calm.svg" width="300" alt="new-year-fireworks-calm"><br>**new-year-fireworks-calm**](themes/new-year-fireworks-calm) | [<img src="docs/previews/night-market.svg" width="300" alt="night-market"><br>**night-market**](themes/night-market)
- [<img src="docs/previews/night-train.svg" width="300" alt="night-train"><br>**night-train**](themes/night-train) | [<img src="docs/previews/origami-bay.svg" width="300" alt="origami-bay"><br>**origami-bay**](themes/origami-bay) | [<img src="docs/previews/oscilloscope.svg" width="300" alt="oscilloscope"><br>**oscilloscope**](themes/oscilloscope)
- [<img src="docs/previews/oscilloscope-calm.svg" width="300" alt="oscilloscope-calm"><br>**oscilloscope-calm**](themes/oscilloscope-calm) | [<img src="docs/previews/paperback.png" width="300" alt="paperback"><br>**paperback**](themes/paperback) | [<img src="docs/previews/papercut-peaks.svg" width="300" alt="papercut-peaks"><br>**papercut-peaks**](themes/papercut-peaks)
- [<img src="docs/previews/papercut-peaks-night.svg" width="300" alt="papercut-peaks-night"><br>**papercut-peaks-night**](themes/papercut-peaks-night) | [<img src="docs/previews/pirate-cove.svg" width="300" alt="pirate-cove"><br>**pirate-cove**](themes/pirate-cove) | [<img src="docs/previews/pirate-cove-night.svg" width="300" alt="pirate-cove-night"><br>**pirate-cove-night**](themes/pirate-cove-night)
- [<img src="docs/previews/pixel-cafe.svg" width="300" alt="pixel-cafe"><br>**pixel-cafe**](themes/pixel-cafe) | [<img src="docs/previews/rainy-window.svg" width="300" alt="rainy-window"><br>**rainy-window**](themes/rainy-window) | [<img src="docs/previews/reading-room.svg" width="300" alt="reading-room"><br>**reading-room**](themes/reading-room)
- [<img src="docs/previews/real-sky.svg" width="300" alt="real-sky"><br>**real-sky**](themes/real-sky) | [<img src="docs/previews/retro-grid.svg" width="300" alt="retro-grid"><br>**retro-grid**](themes/retro-grid) | [<img src="docs/previews/risograph.svg" width="300" alt="risograph"><br>**risograph**](themes/risograph)
- [<img src="docs/previews/rooftop-garden.svg" width="300" alt="rooftop-garden"><br>**rooftop-garden**](themes/rooftop-garden) | [<img src="docs/previews/rooftop-garden-night.svg" width="300" alt="rooftop-garden-night"><br>**rooftop-garden-night**](themes/rooftop-garden-night) | [<img src="docs/previews/sakura-drift.svg" width="300" alt="sakura-drift"><br>**sakura-drift**](themes/sakura-drift)
- [<img src="docs/previews/snow-cabin.svg" width="300" alt="snow-cabin"><br>**snow-cabin**](themes/snow-cabin) | [<img src="docs/previews/snow-cabin-day.svg" width="300" alt="snow-cabin-day"><br>**snow-cabin-day**](themes/snow-cabin-day) | [<img src="docs/previews/snow-station.svg" width="300" alt="snow-station"><br>**snow-station**](themes/snow-station)
- [<img src="docs/previews/spooky-hollow.svg" width="300" alt="spooky-hollow"><br>**spooky-hollow**](themes/spooky-hollow) | [<img src="docs/previews/spring-rain.svg" width="300" alt="spring-rain"><br>**spring-rain**](themes/spring-rain) | [<img src="docs/previews/stained-glass.svg" width="300" alt="stained-glass"><br>**stained-glass**](themes/stained-glass)
- [<img src="docs/previews/summer-fireflies.svg" width="300" alt="summer-fireflies"><br>**summer-fireflies**](themes/summer-fireflies) | [<img src="docs/previews/sunny-shore.svg" width="300" alt="sunny-shore"><br>**sunny-shore**](themes/sunny-shore) | [<img src="docs/previews/tide.svg" width="300" alt="tide"><br>**tide**](themes/tide)
- [<img src="docs/previews/tide-pool.svg" width="300" alt="tide-pool"><br>**tide-pool**](themes/tide-pool) | [<img src="docs/previews/torch-dungeon.svg" width="300" alt="torch-dungeon"><br>**torch-dungeon**](themes/torch-dungeon) | [<img src="docs/previews/ukiyo-e-wave.svg" width="300" alt="ukiyo-e-wave"><br>**ukiyo-e-wave**](themes/ukiyo-e-wave)
- [<img src="docs/previews/weather-mood.svg" width="300" alt="weather-mood"><br>**weather-mood**](themes/weather-mood) | [<img src="docs/previews/weekly-sky.svg" width="300" alt="weekly-sky"><br>**weekly-sky**](themes/weekly-sky) | [<img src="docs/previews/winter-lights.svg" width="300" alt="winter-lights"><br>**winter-lights**](themes/winter-lights)
- <!-- previews:end -->
- *Previews show each theme's backdrop alone (real screenshots are below), and they move (a theme with colors only shows its palette). The [live gallery](https://perspicaciousguy.github.io/ClaudeCodeThemes/) shows them as one page with the install line under each.*
- ### In the app
- The same themes in the desktop app, with the `/ccthemes` picker open over them: the panels are frosted over the backdrop so text stays readable.
- | | | |
- | --- | --- | --- |
- | <img src="docs/screenshots/contour-map.webp" alt="contour-map in the desktop app"><br>**contour-map** | <img src="docs/screenshots/desert-noon.webp" alt="desert-noon in the desktop app"><br>**desert-noon** | <img src="docs/screenshots/fog-valley.webp" alt="fog-valley in the desktop app"><br>**fog-valley** |
- | <img src="docs/screenshots/forest-trail.png" alt="forest-trail in the desktop app"><br>**forest-trail** | <img src="docs/screenshots/papercut-peaks.png" alt="papercut-peaks in the desktop app"><br>**papercut-peaks** | <img src="docs/screenshots/hearth.webp" alt="hearth in the desktop app"><br>**hearth** |
- <!-- themes:start -->
- | Theme | What it is |
- | --- | --- |
- | [**abyss-lantern**](themes/abyss-lantern) | The deep sea: sun shafts fading into the dark, glowing jellyfish, swaying kelp, bubbles and a passing school of fish. Dark. |
- | [**arcade-hall**](themes/arcade-hall) | A pixel-art arcade at night: rows of cabinets playing their own little games, neon tubes and a patterned carpet. Dark. |
- | [**art-deco**](themes/art-deco) | A 1920s deco poster: a gold sunburst over deep navy, stepped towers with gold-lined windows, concentric fan arcs and a shimmer of light crossing the gold. Dark. |
- | [**aurora-field**](themes/aurora-field) | Northern lights over a frozen lake ringed by pines, with twinkling stars and the odd shooting star. Dark. |
- | [**autumn-forest**](themes/autumn-forest) | A forest in autumn at golden dusk: trees in red, orange and gold, leaves spiraling down, slanting light and a carpet of fallen leaves. Dark. |
- | [**bamboo-grove**](themes/bamboo-grove) | A bamboo grove in morning mist: tall green stalks in layers fading into haze, leaves swaying, slow light shafts and a few leaves falling. Light. |
- | [**beacon-cove**](themes/beacon-cove) | An animated pixel-art theme that follows your clock: a lighthouse cape and sea from night through dawn, day and dusk, with a moving sun and moon, drifting clouds, a small boat and fireflies. |
- | [**blueprint**](themes/blueprint) | An architect's blueprint: a fine grid on deep blue paper, with a gear, a house elevation, a beam section and a compass drawing that trace themselves in white line. Dark. |
- | [**campfire**](themes/campfire) | A night camp whose fire follows your 5-hour usage window and whose woodpile follows your context window: a roaring fire when plenty is left, embers when you are near the limit. A live theme. Dark. |
- | [**cassette-futurism**](themes/cassette-futurism) | A 1980s vision of the future: an amber monochrome console with a sweeping radar, a spectrum, scrolling data, turning cassette reels, blinking lights and scanlines. Dark. |
- | [**circuit-board**](themes/circuit-board) | A green circuit board: traces between pads and chips, bright pulses of light running along them and small LEDs blinking on their own beats. Dark. |
- | [**circuit-board-calm**](themes/circuit-board-calm) | A calm version of circuit-board: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark |
- | [**cloud-sea**](themes/cloud-sea) | Sunrise above a sea of clouds: rolling banks of cloud drifting between dark peaks, a low sun, birds and a pastel sky from peach to blue. Light. |
- | [**code-rain**](themes/code-rain) | Columns of falling glyphs in phosphor green, bright at the head and fading behind, dimmer under the chat. Dark. |
- | [**code-rain-calm**](themes/code-rain-calm) | A calm version of code-rain: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark |
- | [**colorblind-safe-dark**](themes/colorblind-safe-dark) | A dark theme whose colors stay apart for red-green and blue-yellow color blindness: blue and orange for added and removed, and a different lightness for each status. Colors only. |
- | [**colorblind-safe-light**](themes/colorblind-safe-light) | A light theme whose colors stay apart for red-green and blue-yellow color blindness: blue and orange for added and removed, and a different lightness for each status. Colors only. |
- | [**constellations**](themes/constellations) | A star map: rings and meridians of a celestial chart on deep blue, with constellations that draw themselves star to star, hold, then fade, and shooting stars. Dark. |
- | [**contour-map**](themes/contour-map) | A topographic survey on warm paper: elevation lines draw themselves one height at a time around a flat basin. Light. |
- | [**contour-map-night**](themes/contour-map-night) | The topographic survey in pale ink on blue-black paper, with the contours drawing themselves. Dark. |
- | [**coral-reef**](themes/coral-reef) | A sunlit coral reef: caustic light rippling over branching corals and sea fans, schools of bright fish, a clownfish in an anemone, a turtle gliding by and rising bubbles. Dark. |
- | [**coral-reef-calm**](themes/coral-reef-calm) | A calm version of coral-reef: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark |
- | [**desert-night**](themes/desert-night) | A desert after dark: stars and a cold moon over blue-violet mesas, saguaros in silhouette, a campfire with sparks and an owl. Dark. |
- | [**desert-noon**](themes/desert-noon) | A bright desert at midday: red mesas, a pale sun, saguaros, heat shimmer, drifting dust and a tumbleweed. Light. |
- | [**fog-valley**](themes/fog-valley) | A misty mountain morning: blue ridges with fog drifting between them, low sun rays, a flock of birds and a far balloon. Light. |
- | [**fog-valley-night**](themes/fog-valley-night) | A misty mountain night: a moon over deep-blue ridges, pale fog drifting between them, fireflies in the pines and a sky lantern rising. Dark. |
- | [**forest-floor**](themes/forest-floor) | Moss, bark and fern: a green-brown dark theme and a pale lichen light one, with a fern-green accent. Colors only. |
- | [**forest-trail**](themes/forest-trail) | A pixel-art forest trail on a bright morning: sunbeams through layered trees, a winding dirt path, drifting mist, butterflies and falling leaves. Light. |
- | [**graphite**](themes/graphite) | Neutral graphite grays with one steel-blue accent. Quiet and tool-like, light and dark, colors only. |
- | [**greenhouse-rain**](themes/greenhouse-rain) | A glass greenhouse at dusk in the rain: streaks and drops running down the panes, big leaves and ferns swaying inside, warm hanging lamps and a drifting mist. Dark. |
- | [**halftone-harbor**](themes/halftone-harbor) | A two-ink halftone print of a harbor at sunset: a coral sun and its wake, blue water, a headland with a lighthouse, two boats. Light. |
- | [**halftone-harbor-night**](themes/halftone-harbor-night) | The halftone harbor printed on night-blue stock: an ember sun and pale-blue water in breathing dots. Dark. |
- | [**halloween-night**](themes/halloween-night) | A haunted hill on Halloween: a huge orange moon, a crooked manor with flickering windows, bats, drifting ghosts, glowing jack-o'-lanterns and fog among the gravestones. Dark. A vector companion to haunted-manor. |
- | [**harvest-moon**](themes/harvest-moon) | A huge orange moon over a wheat field: wheat swaying in waves, hay bales and a barn in silhouette, crows crossing the moon and stars coming out. Dark. |
- | [**haunted-manor**](themes/haunted-manor) | A pixel-art haunted manor under a huge moon: flickering windows, bats crossing the sky, a bare tree, drifting ground fog and an iron fence. Dark. |
- | [**hearth**](themes/hearth) | A warm theme: espresso and cream surfaces, terracotta accents, and a slow dusk backdrop with embers drifting up. |
- | [**high-contrast-dark**](themes/high-contrast-dark) | Pure black and white with bright, saturated colors: text well past the AA bar on every surface, and strong borders. Dark, colors only. |
- | [**high-contrast-light**](themes/high-contrast-light) | Black on white with deep, saturated colors: text well past the AA bar on every surface, and strong borders. Light, colors only. |
- | [**ink-wash**](themes/ink-wash) | A sumi-e painting on rice paper: mountains in grey washes fading into mist, a pine branch, a lone boat, birds crossing and a red seal. Light. |
- | [**isometric-room**](themes/isometric-room) | A small isometric room at night: a desk with a glowing monitor and lamp, a plant, a bookshelf, a window onto a moonlit sky and a cat asleep on the rug. Dark. |
- | [**koi-pond**](themes/koi-pond) | A koi pond seen from above at dusk: orange and white koi gliding in slow loops, lily pads with pink flowers, ripples spreading and petals drifting on dark water. Dark. |
- | [**lantern-festival**](themes/lantern-festival) | A lantern festival on a lake at night: paper lanterns rising into a starry sky, their warm light shimmering on the water, a pagoda and hills in silhouette. Dark. |
- | [**low-orbit**](themes/low-orbit) | A pixel-art view of space: a ringed gas giant, a small moon, a nebula, parallax stars, a passing ship and shooting stars. Dark. |
- | [**meadow-hours**](themes/meadow-hours) | A rolling meadow that follows your clock: dawn, day, dusk and night, with a moving sun and moon, butterflies by day and fireflies after dark. Dark. |
- | [**midnight-ink**](themes/midnight-ink) | Blue-black ink with pale paper-white text and a periwinkle accent. Dark, colors only. |
- | [**moonlit-shore**](themes/moonlit-shore) | A pixel-art beach at night: a moon and its glitter on the sea, stars, a campfire with sparks, a lantern boat and a crab. Dark. |
- | [**neon-rain**](themes/neon-rain) | A pixel-art city at night in the rain: towers with lit windows, buzzing neon signs, a wet street and a passing car. Dark. |
- | [**neon-rain-calm**](themes/neon-rain-calm) | A calm version of neon-rain: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark |
- | [**new-year-fireworks**](themes/new-year-fireworks) | New Year's night over a city: rockets climbing and bursting in rings of colored sparks that fall as they fade, lit windows and stars through the smoke. Dark. |
- | [**new-year-fireworks-calm**](themes/new-year-fireworks-calm) | A calm version of new-year-fireworks: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark |
- | [**night-market**](themes/night-market) | A pixel-art night market: strings of paper lanterns swinging over a lane, two glowing food stalls with rising steam, puddles that carry the light and a cat on a crate. Dark. |
- | [**night-train**](themes/night-train) | A night run seen from a carriage window: hills, town lights and telegraph poles sliding past under a thin moon. Dark. |
- | [**origami-bay**](themes/origami-bay) | A bay made of folded paper: layered paper waves that drift, an origami sailboat bobbing, folded cranes flying across a paper sun and clouds. Light. |
- | [**oscilloscope**](themes/oscilloscope) | An oscilloscope screen: a glowing green graticule with a sine, a two-tone, a square and a triangle wave scrolling across and a cursor sweeping the display. Dark. |
- | [**oscilloscope-calm**](themes/oscilloscope-calm) | A calm version of oscilloscope: the same scene slowed to about 40% speed and softened under a veil, with heavier frosted panels, for when motion is distracting. Dark |
- | [**paperback**](themes/paperback) | A well-read paperback: cream pages, brown-black ink and an ink-blue accent. Light, colors only. |
- | [**papercut-peaks**](themes/papercut-peaks) | Five sheets of colored paper layered into mountains, each casting a soft shadow, with paper clouds and birds. Light. |
- | [**papercut-peaks-night**](themes/papercut-peaks-night) | The paper-cut mountains in deep indigo under a paper moon and cut-out stars. Dark. |
- | [**pirate-cove**](themes/pirate-cove) | A pirate galleon in a sunny cove: a skull flag waving, gulls overhead, a far sail on the horizon and a treasure chest on a palm beach. Light. |
- | [**pirate-cove-night**](themes/pirate-cove-night) | A pirate galleon under a full moon: a skull flag waving, lantern light at the stern, a far ship on the horizon and a treasure chest glowing on a palm islet. Dark. |
- | [**pixel-cafe**](themes/pixel-cafe) | A pixel-art cafe on a rainy night: rain running down a big window over blurred city lights, warm pendant lamps, a steaming cup on the counter and a cat asleep on the sill. Dark. |
- | [**rainy-window**](themes/rainy-window) | A night city seen through a rain-streaked window: soft bokeh lights, drops sliding down the glass, a warm lamp and a steaming mug. Dark. |
- | [**reading-room**](themes/reading-room) | A cozy library at night: tall shelves of books, a floor lamp with dust turning in its light, a candle, a cup of tea and a sleeping cat. Dark. |
- | [**real-sky**](themes/real-sky) | A lakeside view under the sky outside right now: the sun crosses from sunrise to sunset by your clock, and at night the moon crosses in its real phase for today, with stars and its reflection in the lake. A live theme. Dark. |
- | [**retro-grid**](themes/retro-grid) | A neon horizon: a slatted sun, wireframe mountains and a perspective grid that rolls toward you. Dark. |
- | [**risograph**](themes/risograph) | A risograph print: fluorescent pink, teal and yellow shapes overprinting on warm paper with halftone dots and slight misregistration, drifting as if the ink were still wet. Light. |
- | [**rooftop-garden**](themes/rooftop-garden) | A pixel-art rooftop at golden hour: a pastel skyline, planters of sunflowers and tomatoes, string lights, birds on a wire and a kite. Light. |
- | [**rooftop-garden-night**](themes/rooftop-garden-night) | A pixel-art rooftop after dark: a moon and stars over a skyline of lit windows, glowing string lights, fireflies and a lantern. Dark. |
- | [**sakura-drift**](themes/sakura-drift) | A spring dusk of pastel sky, misty hills and a blossoming tree, with petals drifting down. Light and dark. |
- | [**snow-cabin**](themes/snow-cabin) | A winter night: a log cabin with a lit window, smoke curling from the chimney, snowy pines and snow falling in three layers. Dark. |
- | [**snow-cabin-day**](themes/snow-cabin-day) | A winter noon: a pale blue sky and low sun, white hills, a log cabin with smoke from its chimney and snow falling in three layers. Light. |
- | [**snow-station**](themes/snow-station) | A pixel-art train station in a night snowfall: snow drifting past warm lamps, a slow night train on the far track, a glowing clock on the gable and a bench under the canopy. Dark. |
- | [**spooky-hollow**](themes/spooky-hollow) | A haunted graveyard under a full moon: a dead tree with a swinging green lantern and a blinking owl, tilted tombstones, drifting ghosts and wisps, bats crossing the sky, a crooked house with a flickering window and a glowing pumpkin. Dark. |
- | [**spring-rain**](themes/spring-rain) | A soft spring rain over pale green hills: blossoming trees shedding petals, rain streaking through, puddles rippling under a pastel sky. Light. |
- | [**stained-glass**](themes/stained-glass) | A cathedral window at night: four arched lancets of jewel-colored panes in dark lead, a slowly turning rose window and light drifting across the glass. Dark. |
- | [**summer-fireflies**](themes/summer-fireflies) | A meadow at dusk: fireflies blinking and drifting over swaying grass, a thin moon, first stars and the last orange glow on the horizon. Dark. |
- | [**sunny-shore**](themes/sunny-shore) | A pixel-art beach on a bright day: a pulsing sun, drifting clouds, a sparkling sea, rolling foam, palms, gulls and a crab. Light. |
- | [**tide**](themes/tide) | A beach at dusk whose tide follows your 5-hour usage window: high water while plenty is left, then the sea draws back and leaves wet sand, rocks, tide pools and a stranded boat. A live theme. Dark. |
- | [**tide-pool**](themes/tide-pool) | Looking straight down into a rock pool: breathing anemones, starfish, rippling light, drops making rings and small fish. Dark. |
- | [**torch-dungeon**](themes/torch-dungeon) | A pixel-art dungeon wall: two flickering torches, a dark doorway with watching eyes, bats, a hopping slime and a treasure chest. Dark. |
- | [**ukiyo-e-wave**](themes/ukiyo-e-wave) | A Japanese woodblock print: a great wave curling over scale-pattern swells, boats riding the water, a red sun and a snow-capped mountain on cream paper. Light. |
- | [**weather-mood**](themes/weather-mood) | A lighthouse on a rocky headland whose weather follows Claude: a clear calm night while it is idle, clouds and rain while it works (harder as the context window fills) and a flash of lightning when a tool call fails. A live theme. Dark. |
- | [**weekly-sky**](themes/weekly-sky) | A lakeside cabin under a sky that crosses a whole day as your 7-day usage window is used: sunrise at the start of the week, noon in the middle, sunset as you near the limit and night when you reach it. A live theme. Dark. |
- | [**winter-lights**](themes/winter-lights) | A snowy night dressed for the holidays: strings of colored lights twinkling in three phases, lit fir trees and a cottage, falling snow and a bright moon. Dark. |
- <!-- themes:end -->
- ## Install
- You need the Claude Code desktop app. Themes draw there (and in the mobile app); the terminal and editor extensions don't draw themes.
- There are two ways to install: **the whole library as one plugin** (recommended), or **one theme at a time**.
- ### The whole library: `theme-library`
- One plugin holds every theme and a switcher, so you install once and change themes whenever you like.
- In the desktop app: click **+** next to the prompt box, then **Plugins**, choose **Add marketplace** and enter `PerspicaciousGuy/ClaudeCodeThemes`, then **Add plugin** and pick `theme-library`.
- Or at the prompt of a terminal Claude Code session:
- ```
- /plugin install theme-library --marketplace PerspicaciousGuy/ClaudeCodeThemes
- ```
- Or from a shell:
- ```bash
- claude plugin install theme-library --marketplace PerspicaciousGuy/ClaudeCodeThemes
- ```
- Then, in a session:
- | Command | What it does |
- | --- | --- |
- | `/ccthemes` | Opens a card of themes you can filter (dark, light, pixel, vector, still, clock): Apply, Preview (20 seconds, not kept) and No theme |
- | `/ccthemes <name>` | Applies a theme, such as `/ccthemes neon-rain` (a unique start of the name works) |
- | `/ccthemes dark`, `light`, `pixel`, `vector`, `still`, `clock` | Opens the card with that filter on |
- | `/ccthemes find <words>` | Searches names, tags and descriptions, such as `find beach` |
- | `/ccthemes widgets [on or off]` | Lays four widgets over your theme: context window fill, 5-hour and 7-day limits used, the time until each limit resets and session cost, in a shape and look that match the theme (19 in all, from tombstones to scrolls, taped notes and brass portholes: paper, neon, pixel, blueprint, deco, frost, wood, ink, riso, terminal, amber, pastel, spooky, reef, dune, ice, festive, porthole and leaf). Off by default; works over any theme with a scene |
- | `/ccthemes widgets left`, `right` or `both` | Moves the widgets to the left, the right (the default) or one column on each edge |
- | `/ccthemes widgets look neon` | Uses one look on every theme instead of matching each; `look auto` goes back. The looks are paper, neon, pixel, blueprint, deco, frost, wood, ink, riso, terminal, amber, pastel, spooky, reef, dune, ice, festive, porthole and leaf |
- | `/ccthemes mascot [on, tile, walk or off]` | Adds a small orange critter, in the spirit of the Claude Code mascot. It rests, works at a laptop while Claude does, hops when a turn ends, looks worried when context is nearly full and naps when a limit is hit. `tile` puts it beside the widgets, `walk` lets it stroll along the bottom of the scene, `on` does both. It wears a hat that suits the theme (pirate, witch, shades, straw hat, beanie and more) |
- | `/ccthemes auto` | Day and night: themes with a twin switch between their light and dark halves by your clock |
- | `/ccthemes list` | Names every theme |
- | `/ccthemes random` / `next` / `prev` | Applies a random, the next or the previous theme, optionally within a filter |
- | `/ccthemes off` | Clears the theme |
- The theme you apply is kept for later sessions, in every project. In a new session no theme shows until you send a first message.
- ### One theme at a time
- Install a single theme instead of the library:
- ```
- /plugin install beacon-cove --marketplace PerspicaciousGuy/ClaudeCodeThemes
- ```
- ```bash
- claude plugin install beacon-cove --marketplace PerspicaciousGuy/ClaudeCodeThemes
- ```
- Replace `beacon-cove` with any theme's name from the table above. The first time, Claude Code asks `Add marketplace?`: answer `y`, then choose a scope (the user scope applies to every session). A theme installed from a terminal at the user scope also loads in your desktop app's local sessions. The theme applies at the start of a session: if it doesn't show, start a new session.
- A session has one theme, so if two single themes (or one and the library) are installed they overwrite each other. Use one route or the other, or switch with:
- ```bash
- claude plugin disable hearth
- claude plugin enable beacon-cove
- ```
- To remove a theme: `claude plugin uninstall <theme>`.
- ## Good to know
- - **If the backdrop doesn't show.** The colors can apply while the scene stays hidden. On Windows, turn on Settings, Personalization, Colors, Transparency effects. Then start a new session and send a message.
- - **Light and dark.** Hearth follows your app's light or dark mode. Beacon Cove is a dark theme and keeps the app dark.
- - **Reduced motion.** Animated backdrops stop moving when your system asks for reduced motion.
- - **Permission prompts** always keep the app's own look.
- - **Beacon Cove and your clock.** It reads your computer's local time and redraws its sky every ten minutes.
- ## Make your own
- Start from [`template/`](template), a minimal colors-only theme, and read [CONTRIBUTING.md](CONTRIBUTING.md) for how a theme works, the quality bar, how to test one locally, and how to add it here.
- ## License
- [MIT](LICENSE). Each theme's art is original to this repository.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.