Commands

The /glowup commandCopy Anchor Link

/glowup with no arguments, or with help, prints a card with the five commands most people need:

glowup

  /glowup config                       open the config pane: pack, colors, layout
  /glowup pack <name>                  switch look: arcade classic cozy crt
  /glowup pet clawd|robot|off          pick a pet, or none
  /glowup pane                         open or close the side pane
  /glowup motion reduced               calm everything down

more: /glowup help all   docs: https://glowup.khimani.dev/

/glowup help all lists every command in groups: Start here, Look, Pet, Comfort, Make your own and Status line. The Look group includes the color commands.

In the terminal and the desktop app, the card is drawn in your pack's colors with a header box, color swatches and the spinner word; the model, and any other client, sees the plain text above. An unknown subcommand prints Unknown: <what you typed> above the card.

Look, pet, motion and status line choices are saved and carry over to later sessions.

themeCopy Anchor Link

A theme replaces the current pack's palette and keeps its row style, border and extras. If the theme fails to load, glowup prints why and stays on the current one. The built-in themes are classic (the default), glowup, aurora, dusk, cyberpunk, vaporwave and high-contrast; your own are read from ~/.claude/glowup/themes. See Making a theme.

theme addCopy Anchor Link

theme add takes an https:// URL to a single JSON file. It then:

1. Refuses anything that is not https://.
2. Downloads the file. A download over 64 KB is refused.
3. Reads the name field. The name must be lowercase letters, digits and dashes, start with a letter or digit, and be at most 40 characters.
4. Refuses a name that is one of the built-in themes.
5. Checks the whole file, including the extends chain, against the theme reference.
6. Saves it as <name>.json in ~/.claude/glowup/themes.

Each refusal prints a message naming the failed check. Adding a theme whose name you already have silently replaces your file. theme add installs without switching, so follow it with /glowup theme <name>.

packCopy Anchor Link

spinnerCopy Anchor Link

/glowup pack <name> clears a spinner override, so choose the pack first and the spinner after.

The built-in packs are classic (the default), crt, cozy and arcade. If a pack fails to load, glowup prints why and keeps the current look. The file format and limits are in Packs.

colorCopy Anchor Link

The roles are the ones in the theme reference: accent, text, dim, faint, read, edit, shell, agent, pass, fail, panel, addBg, delBg and sel. An unknown role or a bad hex prints the reason and changes nothing.

An override sits on top of whatever pack and theme are active and survives switching either. /glowup export konsole and /glowup pack save <name> include it. It does not touch a pack's gradient, border color or spinner color.

importCopy Anchor Link

/glowup import <file> turns a Ghostty or base16 color scheme into a pack with a colors layer, saves it in ~/.claude/glowup/packs and applies it. The file can be at most 64 KB. Add --force to replace an installed pack of the same name. See Packs.

exportCopy Anchor Link

/glowup export konsole writes your current colors as a Konsole color scheme to $XDG_DATA_HOME/konsole/glowup-<pack>.colorscheme (~/.local/share/konsole/ when XDG_DATA_HOME is not set), replacing an earlier export of the same name. In Konsole it appears under Settings → Edit Current Profile → Appearance.

pet and bubblesCopy Anchor Link

See Pets, and Pet sprites for drawing your own.

setupCopy Anchor Link

Your layout and behavior settings. They are yours alone: installing someone's pack never changes them.

configCopy Anchor Link

/glowup config opens a pane with a row for each choice, a preview of the look under them, and Done, Copy studio link and Reset at the bottom. Up and down move between rows.

The rows are Pack, Spinner, one for each color role, Band, Tabs, Meter, Pet, Sleeps, Bubbles, Bubble, Moods, Motion and Status. A row shown as ‹ value › cycles to its next value when you press Enter and applies it at once. The other rows are fields you type into and submit with Enter. A field you have not edited does nothing on Enter.

A color field takes a hex such as #8ecbff or 8ecbff, and an empty one clears that role's override. Band, Tabs, Moods and Status take a list separated by commas or spaces, and the order you type is the order glowup draws them. An empty Band or Moods field means none, an empty Status field means the default fields, and Tabs needs at least one. The pane says what it did, or why it refused, on the line under the buttons.

Done, or Esc, closes the pane. Copy studio link puts a link to the studio on the clipboard, and the pane says so when the copy fails, as on a surface with no clipboard. Reset asks first, then clears your color overrides and your setup.

Each row has the same effect as the matching command (pack, spinner, color, setup, pet, bubbles, motion, statusline fields). Mixing layers from different packs and saving a pack are only available as commands. In a -p run, /glowup config prints the command list instead of opening the pane.

Settings and the storeCopy Anchor Link

The mod's settings in Claude Code's /plugin menu (pack, theme, spinner, pet, bubbles, statusline and reducedMotion) and the /glowup commands change the same saved choices, and the most recent change is the one in effect.

glowup remembers the /plugin values it last saw. If one differs at the next session start or after /reload-plugins, glowup runs the matching command (/glowup pack crt for a new pack, and so on) and shows a toast saying what it applied. A value it cannot apply, such as an unknown pack name, gets a toast and is not retried. When pack changes, glowup puts the /plugin theme and spinner back on top of the new pack.

Setting theme back to classic, spinner to pack or statusline to its default list clears the saved choice, as /glowup theme default, /glowup spinner default and /glowup statusline fields default do, rather than saving the default value.

paneCopy Anchor Link

/glowup pane toggles the pane, or prints why it cannot open when there is no room. Esc also closes a pane opened this way. Where it opens depends on terminal width; see Layout.

motionCopy Anchor Link

See Accessibility for what reduced motion changes.

statuslineCopy Anchor Link

The fields are activity, ctx, 5h, week, cost, model, effort, agents, plan, branch, changes and cwd. See Choosing the fields.

Without statusline on, glowup only adds its own entry under the prompt while Claude works. restore puts your line back only if the current one is still glowup's. See Status line.