Go Further

Themes

Agently's theming system lets you customize the look and feel of the app. Choose dark or light mode, set a primary accent color, and override the 6-color label palette.

Dark Mode

Toggle dark mode in Settings → Appearance → Dark Mode, or let Agently follow your system setting.

System

Matches macOS/Windows dark mode setting.

Always Light

Always use light mode regardless of system.

Always Dark

Always use dark mode regardless of system.

Accent Color

The accent color is used for active states, links, brand elements, and highlights throughout the app. Choose from presets or enter a custom hex value.

Agently automatically derives light variants (for backgrounds and hover states) from the accent color so you don't need to manually configure every shade.

6-Color Label Palette

Labels use a 6-color palette that's tied to the theme. You can customize each slot:

{
  "theme": {
    "labelColors": [
      "#00C78B",  // slot 1 (brand green by default)
      "#7C3AED",  // slot 2
      "#3B82F6",  // slot 3
      "#F59E0B",  // slot 4
      "#EF4444",  // slot 5
      "#6B7280"   // slot 6
    ]
  }
}

Colors should be high-contrast against both light and dark backgrounds. Agently automatically shows a warning if a chosen color has insufficient contrast.

Per-Workspace Themes

Each workspace can override the global theme. This makes it easy to visually distinguish between workspaces at a glance.

Configure in Workspace Settings → Appearance. The workspace theme override takes precedence over global preferences.

// ~/.agently/workspaces/<id>/config.json
{
  "theme": {
    "accent": "#7C3AED",
    "darkMode": "dark",
    "labelColors": [
      "#7C3AED",
      "#6366F1",
      "#3B82F6",
      "#06B6D4",
      "#10B981",
      "#6B7280"
    ]
  }
}

Font Settings

Adjust font size and line height for the chat area in Settings → Appearance → Typography:

UI font size: 12px – 16px (default: 14px)
Chat line height: Compact, Normal, Relaxed
Code font: System monospace or custom font family