Carbon UI Themes

Carbon UI Themes is a theme plugin for the Agent Zero Web UI.

It adds a large set of ready-to-use color themes, a fast theme switcher directly in the sidebar, and custom presets that let you build your own look on top of an existing Carbon theme.

What This Plugin Adds

• theme selector directly inside Preferences
• small settings icon next to the theme dropdown
• many bundled dark and light themes
• custom presets with live preview
• quick color editing with a color picker and Hex input
• persistent preset settings inside the plugin configuration

The plugin mainly changes colors while keeping the overall Agent Zero interface structure intact.

Included Themes

Agent Zero

• Agent Zero Default
• Agent Zero Default Dark

Carbon Dark

• Carbon Dark · Blurple Chat
• Carbon Dark · Blush Slate Dark
• Carbon Dark · Code Forge
• Carbon Dark · Digital Rain
• Carbon Dark · Ebony Amber Dark
• Carbon Dark · Forest
• Carbon Dark · Heart of Darkness
• Carbon Dark · Indigo Turquoise Dark
• Carbon Dark · Lambda Core
• Carbon Dark · Mocha Paws
• Carbon Dark · Nightfang
• Carbon Dark · Nord
• Carbon Dark · Nordic
• Carbon Dark · Solo Night
• Carbon Dark · Tropical Midnight Dark
• Carbon Dark · Vapor Classic
• Carbon Dark · Vapor Deck

Carbon Light

• Carbon Light · Amber Glow Light
• Carbon Light · Aurora Light
• Carbon Light · Azure Silence Light
• Carbon Light · Blush Slate Light
• Carbon Light · Console Horizon Light
• Carbon Light · Jade Matrix Light
• Carbon Light · Jade Mint Light
• Carbon Light · Kawaii Pastel
• Carbon Light · Miami Neon Light
• Carbon Light · Playlist Mint
• Carbon Light · Retro 98
• Carbon Light · Steel Mist Light
• Carbon Light · Winter Blossom Light

Installation

Place the Plugin in Agent Zero

Clone or copy this repository into the Agent Zero plugin directory:

git clone https://github.com/mariojacob/a0_carbon_theme.git a0_carbon_theme

Target path:

usr/plugins/a0_carbon_theme/

Then restart Agent Zero or reload plugins and enable the plugin.

How To Use It

Quick Theme Switching

In the sidebar under Preferences, the plugin replaces the old Dark Mode row with:

• a theme dropdown
• a small settings icon

When you choose a theme there, it is applied immediately.

Open the Plugin Settings

You can find the full settings here:

Settings -> Agent Settings -> Plugins -> Carbon UI Themes

Or open them directly with the small settings icon next to the sidebar theme dropdown.

Custom Presets

Custom presets let you start from an existing Carbon theme and adjust it to your own taste.

How It Works

1. Create a new preset
2. Choose a Carbon base theme
3. Adjust colors with the picker or Hex field
4. Save the preset

If you click a custom preset in the preset list, it becomes active immediately.

Live Preview

• Current active theme applies immediately
• color changes are visible immediately
• base theme changes are visible immediately
• Save stores the result permanently
• closing without saving restores the last saved state

Important Notes

• Only Carbon themes are available as base themes for custom presets
• Agent Zero default themes are still available as normal themes, but not as custom preset bases
• New custom presets are automatically added to the top of the theme dropdown

What You Can Customize

Custom presets currently support these color groups:

• background areas
• panels and surfaces
• borders
• primary and secondary text
• accent colors
• user and assistant chat bubbles

Notes

• Dark themes run on top of Agent Zero's native dark mode
• Light themes run on top of Agent Zero's native light mode
• Older legacy theme IDs are migrated automatically

For Developers

If you want to add a new built-in theme to the plugin:

1. Create a CSS file in webui/themes/
2. Register the theme in webui/theme-registry.js
3. Reload Agent Zero

Before releasing or sharing changes:

python scripts/validate_plugin.py

License

MIT