A clearer start for every agent.The Croli user manual: what each screen does, and how to use it.
See the product preview ↗
User manual

Appearance

Settings → Appearance decides what Croli looks like. It is the first screen the settings window lands on, and every change takes effect at once and saves itself — there is no Save button.

The preferences on this screen are saved per device, locally on this machine or in this browser. Another machine or another browser means another appearance; it does not sync with your account, and other clients of the same backend never read it.

One exception: the background image itself lives on the backend. The image bytes are a file on the backend host (~/.croli/backgrounds/background.img) and every client of the same Croli backend shares that one picture; what is saved per device is only how it is displayed (the switch, mask, blur, fill mode, panel opacity).

The app language is not here, it is in System.

Theme mode

A dropdown with three settings:

Option Behavior
Follow system Follows the operating system's light/dark setting (default)
Light Always light
Dark Always dark

On the desktop (Tauri / Electron) switching also tells the native window, so the title bar and other system decorations follow along; in a browser it only changes the page itself. Below the dropdown, a line reading "Current effective theme" shows which of light or dark is actually in use after resolution — which only means something under Follow system.

Zoom

Scale the whole interface up or down. Applies immediately, saved per device.

The levels are a fixed set of ten: 80%, 90%, 100% (default), 110%, 125%, 150%, 175%, 200%, 250%, 300%.

Zoom is implemented by changing the root element's font size, so every dimension in the interface measured in rem scales with it. ⌘/Ctrl + = and ⌘/Ctrl + - step through that same set of levels, and ⌘/Ctrl + 0 returns to 100% — the same set as the dropdown, not a second mechanism. All three shortcuts can be rebound in Shortcuts.

Fonts

Interface, code editor and terminal each get their own font. Bundled fonts load on demand; the last item in every dropdown is Custom…, which opens a text field where you can name any font installed on your system (Fira Code, for example).

Bundled options:

Category Fonts
Sans-serif System UI, PingFang SC, Inter + PingFang SC, Inter, Geist
Monospace System Monospace, JetBrains Mono, Fira Code, Geist Mono
  • Interface — both sans-serif and monospace are available. Default Inter + PingFang SC.
  • Editor — monospace only. Default System Monospace, font size default 13px (nine steps from 10 to 20px). Two switches:
    • Enable font ligatures — off by default. Only JetBrains Mono and Fira Code carry ligatures; pick another bundled font and the switch greys out and rewrites itself as "This font has no ligatures". A custom font is treated as possibly having ligatures, so the switch stays usable.
    • Enable word wrap — off by default. Affects the Monaco code editor only.
  • Terminal — monospace only as well, default System Monospace at 13px, with the same ligature rules. Terminal ligatures apply only to bundled coding fonts.

At the bottom is a read-only preview that renders a sample of text in each of the three current settings.

Workspace background

Put an image behind the whole workspace. When on, the sidebar and panels turn translucent and frosted so the image shows through, with a mask layered over it to keep text readable.

Enable background image is off by default, and everything else in this section is greyed out while it is off.

  • Image — Choose image picks one from your machine (with an image already set, the button becomes Replace image and a Remove appears next to it). PNG, JPEG, WebP and GIF are supported, animated images play automatically, and a single image may not exceed 16 MB. Both the file size and the actual format are checked, with errors reported in place; once it passes, other windows pick up the new image on their own.
  • Wallpaper market — browse the public gallery at wallhaven.cc and click to download and apply. There is a search box, four categories (All / General / Anime / People), refresh and paging; SFW content only. An entry over 16 MB is marked "Too large for a background" and cannot be applied. This is the only feature on this screen that needs the network.
  • Fill mode — Cover (default), Contain, Center, Tile.
  • Mask opacity — 0–99%, default 82%. Higher values fade the image further toward the theme background, sharpening text contrast.
  • Image blur — 0–24px, default 0.
  • Panel opacity — 0–100%, default 30%. How opaque the sidebar, panels and tab bars are; lower lets more of the image show through.

Chat animations

A single switch, on by default. It governs the collapse/expand, tool call and working status transitions inside the conversation area, plus smooth scrolling. With it off the interface updates instantly with no transitions — but loading spinners keep rotating (those are a status indicator, not decoration).

Chat width

The maximum width of the conversation column and the composer. The slider starts at 640px with an 8px step, and shows "Default (768px)" when nothing is set. The upper bound is computed from the available width of the screen rather than the window — on the desktop, settings live in a separate window, and using its own width as the bound would pin the value far too low.

The value is measured at 100% window zoom and scales with it; a value that is too wide is limited automatically to fit the window. Reset to default is greyed out while there is no custom width.

Besides setting it here, you can drag the left and right edges of the chat column directly.

Worth knowing

  • Appearance is a per-device preference. It does not travel with your account, and it does not sync between several clients of the same backend — the one exception being the background image itself, which lives on the backend.
  • Window zoom and Zoom in / Zoom out / Reset zoom in Shortcuts use the same set of levels.
  • The workspace background image file lives in Croli's data directory (see Privacy and Security).