---
url: https://clusto.app/docs/appearance.md
description: >-
  Configure Clusto navigation, date and time format, command shortcuts, themes,
  editor and terminal colors, and resizable panels.
---

# Appearance & Theming

The Clusto desktop and Android apps support full theming of the UI chrome,
embedded terminals, **and** both CodeMirror-based editors via CSS custom
properties.

## Language

The app interface is available in Czech and English. It follows the system
language: Czech when the system language is Czech, English for everything else.
There is no language setting in the app yet. Czech translations are added screen
by screen, so a screen without a Czech translation shows English. The docs and
the CLI are English only.

## Navigation profiles and density

Open **Customize navigation** from the **Common** folder in the main menu or
press **F1** and run **Customize navigation**. The dialog controls the feature destinations shown in
both the desktop sidebar and mobile menu:

* **Full** shows every feature destination.
* **Simple** shows **Terminals**, **Chats**, **Notes**, and the **Common**
  folder, while hiding the other optional feature destinations. Choosing
  **Simple** on the [first-launch screen](/downloads#first-launch-simple-or-advanced)
  selects this profile; **Advanced** selects Full.
* **Custom** lets you show or hide each feature destination, move visible
  items up or down, and group them into folders. Changing an item while Full or
  Simple is selected switches the profile to Custom.
* **Comfortable** and **Compact** change the vertical spacing between feature
  destinations without changing which ones are visible.

The selected profile, custom order, visibility, density, and footer icons are
stored on the current device. **Reset** restores Full navigation, the default item order,
Comfortable density, and the default footer icons.

### Folders

The **Common** folder holds Locations, Sessions, Cluster, Logs,
Connection, Clusto Assistant, Documentation, Keyboard shortcuts, Customize
navigation, and Settings. It is collapsed by default.

### Sidebar footer icons

At the bottom of the expanded desktop sidebar (under the version) and of the
mobile menu sits a row of icon shortcuts, below the connection stats. By default it holds Documentation, Settings, Cluster, Keyboard
shortcuts, Connection, and Clusto Assistant. In **Customize navigation >
Sidebar footer** you can remove any icon, add any menu destination with **Add
an icon**, and reorder them. Each item shows in one place: an item on the
footer row is left out of the expanded sidebar's menu and the mobile menu. The
collapsed icon-only sidebar has no footer row, so it still lists it. Hiding
an item from the menu keeps its footer icon. **Reset** restores the default
footer too.

Each icon sits on the left or the right side of the row. Right-click an icon
and choose **Align right** or **Align left**, use the align button next to it in
the dialog, or drag it: an icon dropped next to another joins that one's side,
and one dropped on empty space joins the side under the pointer. Moving an icon
up or down past the gap between the sides switches it to the other side.

In the dialog, **New folder** creates a folder. Each folder can be renamed,
moved up or down, and deleted; deleting a folder returns its items to the top
level. Each item has a folder picker (**Top level** or any folder) and up and
down arrows that reorder it within its folder. Settings and Customize navigation
can be moved into any folder but can never be hidden (shown with a lock icon),
so the controls needed to restore Full navigation are always reachable. On
mobile, the configured menu scrolls inside the sheet.

In the collapsed icon-only sidebar, a folder shows as a folder icon, and
clicking it expands its items inline.

The F1 command palette also provides **Use Simple navigation**, **Use Full
navigation**, **Customize navigation**, and **Open Clusto documentation**. The
documentation action opens the public Clusto docs and is also available directly
from the desktop and mobile menus. It also has **New navigation folder**, which
creates a folder and opens **Customize navigation** so you can name it.

### Arranging the menu directly

You can rearrange the sidebar without opening **Customize navigation**.

* **Context menu.** Right-click any menu row (long-press on touch) to get
  **New folder**, **Move to** a folder (or **Move to top level**), **Move to
  bottom row**, **Hide from menu**, and
  **Customize navigation**. The bottom row option appears in the expanded
  desktop sidebar and the mobile menu, which both show the bottom icon row.
* **Folder context menu.** Right-click a folder for **New folder**, **Rename
  folder** (an inline name field), and **Delete folder**. Deleting a folder
  returns its items to the top level.
* **Drag and drop (mouse).** Drag menu items to reorder them, and drop an item
  on a folder to move it in. Drag folders to reorder folders. Drag items onto
  the bottom icon row under the version to move them there. Drag a bottom-row
  icon back into the menu, or along the row to reorder it. **Terminals**,
  **Chats**, and **SSH** drag by their header row.
* **Bottom row icon menu.** Right-click an icon for **Move to menu**, **Align
  left** or **Align right**, and **Customize navigation**. An icon hidden from
  the menu also offers **Remove from bottom row**.
* **Settings and Customize navigation** can never be hidden. On the bottom row
  they leave the expanded sidebar's menu and the mobile menu but stay in the
  collapsed sidebar.
* **New folders** show in the menu while empty, so you can drop items into them.

Any of these changes switches the navigation profile to **Custom**. Switching
from **Simple** keeps the Simple set of items.

## Date and time

**Settings → Appearance → Date and time** sets how Clusto writes dates and times.

* **Date format**: System (follows the OS locale), `24.10.2026` (DD.MM.YYYY),
  `24/10/2026` (DD/MM/YYYY), `10/24/2026` (MM/DD/YYYY) or `2026-10-24` (ISO,
  YYYY-MM-DD).
* **Time format**: System, 24-hour or 12-hour (AM/PM).

The choice applies to every date and time the app shows: the time tracking
calendar, timesheet and entries, task runs and pauses, report day groups, file
modified times, session created times, sync times, node build dates and so on. It
also applies to the date fields in the Add/Edit time entry dialog and the Pause
task **Resume at** field.

Date fields are typed in the chosen format, and the placeholder shows the
pattern, for example `DD.MM.YYYY HH:MM`. Separators `.`, `/`, `-` and spaces all
work, a single-digit day or month is accepted, and a two-digit year such as `26`
means 2026. AM/PM is read whenever you type it. An invalid date such as `31.02.`
is marked red and blocks **Save**. The calendar button next to a field opens the
platform date picker where the platform has one; on Linux desktop there is no
picker, so you type the date.

The setting is stored with your other settings and syncs to your other devices
through [account cloud sync](/cloud-sync) and
[cluster preferences](/cluster-preferences). It is free on every plan. In the F1
palette, **Change date and time format** opens the card.

## Session colors and titles

**Settings > Appearance > Session colors and titles** helps you tell sessions
apart at a glance. It has a title template and color rules.

**Title template.** The template builds the label of a session from these
placeholders: `{conversation}` (the conversation or terminal title),
`{project}`, `{node}`, `{script}` (the command) and `{user}` (the OS user).
Click a placeholder to insert it. A placeholder that is empty for a session
drops out together with the brackets around it, so `[{node}]` leaves nothing
behind on a session without a node. A name you give a session by hand always
wins. A live **Preview** shows the result for an open session, and **Reset to
the default template** restores the default.

**Color rules.** Each rule matches on **Node**, **Command**, **User** or
**Project** and assigns a color. Command and user match part of the text and
ignore case. Rules are checked from the top and the first match colors the
session; reorder them with the up and down buttons. A session no rule matches
keeps its plain look.

**Project overrides.** A project can have its own color and its own template. A
project color beats every rule, and a project template replaces the global one
for that project's sessions.

The color shows as a stripe beside the session in the **Terminals** sidebar, a
dot on the pane tab, and a dot in the mobile session switcher (see
[Terminal Workspace](/terminal-workspace#session-colors-and-titles)). Right-click
a project folder in the sidebar and choose **Session colors and titles**, or run
**Session colors and title template** from the `F1` palette, to open the card.

The settings are stored under the `clusto-session-appearance` key and sync to
your other devices through [account cloud sync](/cloud-sync) and
[cluster preferences](/cluster-preferences). They are free on every plan.

## Feature tips

**Settings > Appearance > Feature tips** controls the short hints that Clusto
shows about features you have not used yet. See [Feature tips](/feature-tips)
for the list. The card has:

* **Show feature tips** - the switch for all tips. Tips start only after you
  have seen the [Clusto terms](/concepts) glossary.
* **Show tips again** - brings back the tips you hid for now, retired with
  **Don't show again**, or finished.

Which tips are retired is saved in your profile settings and follows you to
your other devices; the **Show feature tips** switch is stored on this device.
The `F1` palette has **Turn off feature
tips** and **Show feature tips again**.

## Command palette shortcuts

Press **F1** to search and run actions from anywhere in Clusto. On a phone, tap
the search button in the header instead. Every action has
an editable shortcut badge on the right. The badge shows the current binding, or
**Not set** when the action has no shortcut.

Click or tap a badge, then press the key or key combination you want to assign.
Press **Esc** to cancel recording. The saved shortcut appears immediately and
runs the same action even when that action had no default binding.

Customized actions show a separate **Reset to default** button. Reset restores
the built-in shortcut, or returns the badge to **Not set** when the action has no
built-in binding. Shortcut and reset controls remain visible and touch-sized, and
can also be reached with the keyboard.

On touch screens the shortcut controls are hidden, because a phone has no
keyboard to record a shortcut on; the palette itself works the same.

The **Keyboard shortcuts** dialog lists every shortcut, including the paste and
attachment shortcuts, in Czech or English. It shows `Cmd` and `Option` on macOS
and reflects any binding you changed here.

## Remembered pages and view settings

Clusto remembers where you left each section. Opening a section again from the
sidebar, footer, F1 palette or mobile menu reopens the page you left there,
including its tab, URL filters and any open pull request, report or record.
Clicking the section you are already in goes to its start page. After a restart
the app opens on the last page you had open instead of always Terminals, and
Settings reopens on its last tab.

In-view filters, search, sort and group-by are also remembered on this device
across leaving the view and restarting: the Sessions list, Locations and
Projects, Tasks, Logs, Teams, Agent Docs, Factory, GitHub and Azure DevOps. They
are device-local and not synced across the cluster. Unsent prompt text on a
session page and unsent team message text on a team page are kept per session
or team. GitHub and Azure DevOps filters reset when you switch accounts.

## Where to configure

Open **Settings → Appearance**. It holds **Theme**, **Right sidebar**,
**Date and time**, **Session colors and titles** and **Feature tips**. Terminal font size, padding and the key bar are under
**Settings → Terminal**, and the notes editor font size and spelling check are
under **Settings → Notes**. The theme card contains:

* **Preset** picker - pick a built-in theme. Each theme is a complete light *or*
  dark look; selecting one also sets the app's light/dark mode, so there is no
  separate light/dark toggle. Built-ins: Default Dark/Light, Solarized
  Dark/Light, Dracula Dark/Light, Catppuccin Mocha (dark), Catppuccin Latte
  (light), Nord (dark), Tokyo Night (dark), and Custom.
* **Mode** selector - shown only for the **Custom** theme; chooses whether your
  custom CSS renders as a light or dark theme.
* **CSS variables** editor - folded away by default and opened automatically for a Custom theme. It is a CodeMirror editor showing the active theme. Read-only
  while a built-in preset is selected; pick **Edit as Custom** to fork the active CSS
  into the Custom slot and start editing.
* **Reset** - drops back to the Default theme (matching your OS light/dark
  preference) and clears any custom CSS.

**Right sidebar** - choose which panels (Files, Git, Run) the right sidebar
shows in Terminals, Chats and SSH. Turning every panel off for a view hides the
sidebar there. The card also has **Open diffs of changed files**, on by default,
which opens the Git tab on a file's diff when it changes in the focused
session's project; see [Git changes panel](/git-panel#open-diffs-of-changed-files).
See [Panels per view](/file-explorer#panels-per-view).

Edits in Custom mode apply live to the running app and are persisted in the
device's `localStorage`. Each theme is a single `:root { ... }` block; the
Custom theme's **Mode** selector decides whether it renders light or dark.

## Available variables

UI chrome:

| Variable | Purpose |
|----------|---------|
| `--background` / `--foreground` | App body |
| `--card` / `--card-foreground` | Card surfaces |
| `--popover` / `--popover-foreground` | Popovers, dropdowns |
| `--primary` / `--primary-foreground` | Primary action buttons |
| `--secondary` / `--secondary-foreground` | Secondary surfaces |
| `--muted` / `--muted-foreground` | Muted text and surfaces |
| `--accent` / `--accent-foreground` | Hover / selected states |
| `--destructive` | Destructive actions |
| `--border` / `--input` / `--ring` | Borders, inputs, focus rings |
| `--sidebar*` | Sidebar surface, foreground, primary, accent, border, ring |

Terminal:

| Variable | Purpose |
|----------|---------|
| `--terminal-bg` / `--terminal-fg` | Terminal background / default text |
| `--terminal-cursor` | Cursor color |
| `--terminal-selection-bg` | Mouse selection background |
| `--terminal-black` / `--terminal-bright-black` | ANSI 0 / 8 |
| `--terminal-white` / `--terminal-bright-white` | ANSI 7 / 15 |
| `--terminal-font-family` | Terminal font stack |

ANSI colors 1-6 (red, green, yellow, blue, magenta, cyan) are not driven by
CSS variables; they come from a fixed light/dark palette built into the app.

Editor:

| Variable | Purpose |
|----------|---------|
| `--editor-bg` / `--editor-foreground` | Editor canvas and default text |
| `--editor-gutter-bg` / `--editor-gutter-fg` | Line-number gutter colors |
| `--editor-gutter-active-fg` | Active line number |
| `--editor-border` | Gutter / panel borders |
| `--editor-selection-bg` | Text selection |
| `--editor-active-line-bg` / `--editor-active-line-gutter-bg` | Active line highlight |
| `--editor-cursor` | Caret color |
| `--editor-search-match-*` | Search result highlight fill / border / selected match |
| `--editor-bracket-match-*` | Matching bracket highlight fill / border |

## Example: minimal custom theme

A custom theme is a single `:root` block. Set the **Mode** selector to *light*
or *dark* to tell the app which ANSI palette and `dark:` utilities to use.

```css
:root {
  --background: #1c1b18;
  --foreground: #e6e1d6;
  --primary: #d98a52;
  --editor-bg: #24221f;
  --terminal-bg: #1c1b18;
  --terminal-fg: #e6e1d6;
}
```

## Notes

* Themes are device-local by default. Use **Settings → Sync preferences with
  cluster → Save to cluster** to push the current theme (and every other
  `clusto-*` localStorage preference) to the connected daemon; any client that
  later connects to that cluster can pull the same blob with **Pull from
  cluster**. Sync is opt-in per action: editing locally never touches the
  cluster value.
* The app's base styles define the defaults; your overrides cascade on top of those, so you only need to declare the variables
  you want to change.
* Already-open terminals and editors refresh their colors live when the theme
  changes; no reopen / reattach needed.

## Resizable panels

Every side panel can be resized by dragging the thin handle on its border, the
same gesture used between terminal panes. On desktop (md+) only - on phone
widths these panels are full-width swappable panes or sheets, so the handle is
hidden. Each panel remembers its width across restarts in `localStorage`:

| Panel | Page | Range | Key |
| --- | --- | --- | --- |
| Main navigation (left) | all pages | 180-420 px | `clusto-nav-width` |
| Right sidebar (Files/Git/Run) | Workspace | 220-560 px | `clusto-right-sidebar-width` |
| Notes file tree (left) | Notes | 180-480 px | `clusto-notes-tree-width` |
| Notes editor split divider | Notes (split mode) | 20-80% | `clusto-notes-editor-split` |

The collapsed main nav keeps its fixed narrow rail and is not resizable until
re-expanded.

## Cluster-shared preferences

The daemon persists the synced blob in `cluster_preferences.json` next to its
`config.toml` and broadcasts updates to its cluster peers via
`PeerMessage::SyncClusterPreferences`. Conflict resolution is last-writer-wins
on the whole blob, ordered by a server-side `updated_at` timestamp - so a
slow peer broadcast can never clobber a fresher local write. Wire protocol:
`ClientMessage::GetClusterPreferences` / `SetClusterPreferences` →
`ServerMessage::ClusterPreferences { preferences }`.
