Switch Themes
- Web console: click the version number at the bottom-left and hover “Theme” in the menu to show the theme list
- Desktop app: open the “More” menu at the bottom-left and hover “Theme” to show the theme list

- Meadow (default): fresh green
- Ocean: ocean blue
- Clay: warm terracotta
- Sakura: cherry-blossom pink
- Lavender: lavender purple
Import Themes
Click “Custom theme…” at the bottom of the theme list to open the custom theme dialog, then drag a theme.zip or theme folder onto it. You can also click it to browse instead (in the Windows app, pick the theme.json inside a folder to import that folder). The imported theme is applied right away.
On import CowAgent checks that:
theme.jsonsits at the root of the package, or inside its single top-level folder- Only
theme.jsonand images (jpg/png/webp/gif/svg) are copied; other files are ignored - Each file is at most 16MB and the whole theme at most 64MB
- An existing theme with the same ID is only replaced after you confirm; an ID taken by a built-in theme is renamed automatically
~/cow/system/themes/ (system/themes/ under your Agent workspace if you moved it), one folder per theme; the custom theme dialog shows the path at the bottom. Delete a folder to remove a theme, or copy a theme folder in directly; it shows up the next time you open the theme list. In the desktop app, “Open themes folder” in that dialog opens it for you. When CowAgent runs on a server, the folder is on the machine running CowAgent.
The Web console does not support
shape (corner radius, fonts) yet; colors, wallpapers and logos all work.Theme Structure
theme.json:
Colors
Values accept any CSS color (e.g.#7c4dff, rgba(...)). Keys you leave out fall back to the default theme, and unknown keys are ignored. If the colors make text hard to tell apart from its background, the default theme is used instead.
Wallpaper
One wallpaper is enough: set it at the top level and both light and dark use it. To give each appearance its own image, setwallpaper under light / dark; those take precedence. If only one appearance sets a wallpaper, the other reuses it, and a wallpaper.jpg in the theme folder is used automatically when none is set anywhere.
For different wallpapers per appearance, drop the top-level wallpaper and set one under each of light / dark:
Let the Agent Create a Theme
The Agent can build a theme for you. It writes the theme to~/cow/system/themes/, and if image generation is configured it can generate the wallpaper and logo too.
- Start in one click: click “Start” next to “Let the Agent create one” in the custom theme dialog. It opens a new chat with the prompt filled in, so you only add the style you want at the end and send it.
- Generate from reference images: attach reference images when you send, such as a character, illustration or photo you like. The Agent builds the wallpaper and logo on them, keeping the character and art style consistent, and takes the theme colors from them as well.
- Separate light and dark wallpapers: say “use different wallpapers for light and dark mode” in your style description to get one wallpaper for each mode.
