theme

Theme Personalization

SLICC supports full UI theming via the theme shell command and the Theme settings dialog (avatar menu → "Theme settings…").

Shell Command (preferred for agent use)

theme list                    # List all preset themes
theme apply <id>              # Apply a preset by id
theme apply <path>            # Apply a .slicc-theme.json file from the VFS
theme reset                   # Reset to default theme
theme export <id> <path>      # Export a preset to a VFS path

Unrecognized flags (for example theme list --json) exit non-zero with theme <sub>: unknown flag: … — do not treat exit 0 as proof a flag was honoured.

Agent workflow

1. Write a theme JSON file to the VFS
2. Apply it with theme apply <path>

cat > /shared/my-theme.slicc-theme.json << 'EOF'
{
  "id": "my-theme",
  "name": "My Theme",
  "base": "dark",
  "disableShader": true,
  "tokens": {
    "--canvas": "#0f0f1a",
    "--bg": "#0a0a12",
    "--ghost": "#1a1a2e",
    "--desk": "#1a1a2e",
    "--ink": "#e8e8f0",
    "--deep": "#e8e8f0",
    "--txt-2": "#9898b0",
    "--txt-3": "#686888",
    "--line": "#2a2a40",
    "--ctx": "#6c5ce7",
    "--waffle": "#6c5ce7",
    "--shaderbg": "#0f0f1a",
    "--s2-gray-25": "#0f0f1a",
    "--s2-gray-50": "#141422",
    "--s2-gray-75": "#1a1a2e",
    "--s2-gray-100": "#20203a",
    "--s2-gray-200": "#2a2a45",
    "--s2-gray-300": "#3a3a55",
    "--s2-gray-900": "#e8e8f0",
    "--s2-gray-1000": "#ffffff",
    "--s2-bg-base": "#0f0f1a",
    "--s2-bg-layer-1": "#141422",
    "--s2-bg-layer-2": "#1a1a2e",
    "--s2-bg-elevated": "#20203a",
    "--s2-bg-sunken": "#0a0a12",
    "--s2-content-default": "#e8e8f0",
    "--s2-content-secondary": "#b8b8d0",
    "--s2-content-tertiary": "#8888a0",
    "--s2-accent": "#6c5ce7",
    "--s2-accent-hover": "#8577ed",
    "--s2-accent-down": "#5a4bd4",
    "--s2-border-default": "#2a2a40",
    "--s2-border-subtle": "#222238",
    "--s2-positive": "#2d9d78",
    "--s2-negative": "#e34850"
  }
}
EOF
theme apply /shared/my-theme.slicc-theme.json