Skip to content

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.

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 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.

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 and 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). 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 and 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 for the list. The card has:

  • Show feature tips - the switch for all tips. Tips start only after you have seen the Clusto terms 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. See 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:

VariablePurpose
--background / --foregroundApp body
--card / --card-foregroundCard surfaces
--popover / --popover-foregroundPopovers, dropdowns
--primary / --primary-foregroundPrimary action buttons
--secondary / --secondary-foregroundSecondary surfaces
--muted / --muted-foregroundMuted text and surfaces
--accent / --accent-foregroundHover / selected states
--destructiveDestructive actions
--border / --input / --ringBorders, inputs, focus rings
--sidebar*Sidebar surface, foreground, primary, accent, border, ring

Terminal:

VariablePurpose
--terminal-bg / --terminal-fgTerminal background / default text
--terminal-cursorCursor color
--terminal-selection-bgMouse selection background
--terminal-black / --terminal-bright-blackANSI 0 / 8
--terminal-white / --terminal-bright-whiteANSI 7 / 15
--terminal-font-familyTerminal 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:

VariablePurpose
--editor-bg / --editor-foregroundEditor canvas and default text
--editor-gutter-bg / --editor-gutter-fgLine-number gutter colors
--editor-gutter-active-fgActive line number
--editor-borderGutter / panel borders
--editor-selection-bgText selection
--editor-active-line-bg / --editor-active-line-gutter-bgActive line highlight
--editor-cursorCaret 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:

PanelPageRangeKey
Main navigation (left)all pages180-420 pxclusto-nav-width
Right sidebar (Files/Git/Run)Workspace220-560 pxclusto-right-sidebar-width
Notes file tree (left)Notes180-480 pxclusto-notes-tree-width
Notes editor split dividerNotes (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 }.

Clusto - remote AI coding agents over WebSocket.