> ## Documentation Index > Fetch the complete documentation index at: https://vibex.peatboy.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Settings > Adjust Vibex's interface, workbench, session, terminal, shortcut, and diagnostic options. Open **Settings** (`cmd-,`) to change the desktop's local preferences. Settings do not replace the Agent, MCP, or Skills configuration in the Config Center. A **Search settings** field at the top of the page jumps straight to an option by name or keyword. Options you have changed show **Undo changes** next to them. ## Sections | Section | What you can adjust | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------- | | **General** | Language, startup behavior, network proxy, notifications, and updates. | | **Appearance** | Theme, window zoom, interface and code fonts, motion, and contrast. | | **Workbench** | Sidebar view, default new-session location, preview window host, layout memory, Git change count, and editor autosave. | | **Session** | Conversation content width, timeline display, message queue, auto-continue, and Agent notifications. | | **Terminal** | Default shell and the starting directory for new terminals. | | **Shortcuts** | View, change, and reset keyboard shortcuts. | | **Data & Diagnostics** | Local storage usage and cleanup, plus diagnostics and recovery entry points. | | **Developer** | Instrumentation for profiling the workbench itself: the **FPS monitor** overlay. | | **About** | Version, channel, software updates, license, and platform information. | ## General | Option | Description | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Language** | System default / 简体中文 / 繁體中文 / English. | | **Keep running after closing the window** | Keep Vibex in the system tray after you close the window. | | **Network proxy** | Route Vibex network requests and Agent tools through a local or corporate proxy. Supports `http`, `https`, `socks5`, and `socks5h`. The address is validated before you enable it. | | **Startup** | Restore the workbench on launch, or open a new session directly. | | **Launch at login** | Start Vibex when you sign in to the system. | | **System notifications** | Master switch for desktop notifications. | | **Automatic updates** | Download a signed release as soon as it is found. Install it now, or let Vibex install it when you quit. | | **Update prompts** | Show the title-bar update button and update panel. Background security checks remain enabled. | ## Appearance Controls the theme mode (System / Light / Dark), window zoom (75%–200%), the size and weight of the **Interface font** and **Code font**, **Reduced motion**, and **High contrast**. The code font also applies to code blocks, the integrated editor, and the terminal. **Theme** is chosen with three preview cards — **System**, **Light**, and **Dark** — each painting a miniature workbench in the palette that mode resolves to. **Light theme** and **Dark theme** are independent dropdowns that show the swatch and the theme's name both closed and open. Twenty ship built in: Vibex Light, Catppuccin Latte, Gruvbox Light, Solarized Light, GitHub Light, Rosé Pine Dawn, Everforest Light, Ayu Light, One Light, and Kanagawa Lotus for light; Vibex Dark, Catppuccin Mocha, Gruvbox Dark, Tokyo Night, Nord, Rosé Pine, Everforest Dark, Ayu Dark, Dracula, and Kanagawa Wave for dark. You can extend the list with a JSON theme file in the `themes` folder of the runtime home; name only the colors you want to change and the rest are derived from the surface they are painted on. Fonts are listed from those installed on the system, with a fallback when one is missing. ## Workbench | Option | Description | | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Sidebar hierarchy** | **Session view** (grouped by session) or **Workspace view** (grouped by workspace). | | **Default new-session location** | **Current checkout** or **New worktree**. | | **Preview window** | **Inline** (open in the workbench column, the default) or **Separate window** (pop out into a detached window). The preview panel header's pop-out and dock controls write the same preference. | | **Remember layout** | Remember the sidebar, preview, right rail, and split layouts. | | **Show Git change count** | Show the number of pending changes on the Git icon. | | **Project overrides** | Clear per-project layout overrides. | | **Reset workbench layout** | Restore the workbench layout to its defaults. | | **Autosave** | **Manual** (the save shortcut is the only way to store changes), **After delay** (write back after a typing pause), or **On focus change** (write back when the editor or window loses focus). | | **Autosave delay** | How long typing must pause before a file is written, 250–5000 ms, 1000 ms by default. It appears only with **After delay**. | ## Session Controls the conversation content width (Narrow / Standard / Full width), the timeline entry display (**Session preview rail**, **Agent generation status**, **Reasoning display**, **Expand reasoning by default**, **Command card rendering**, **File edit card rendering**), and message queue behavior: * **Queue sending** — Automatic or Manual. * **Message send key** — Enter or Cmd/Ctrl+Enter. * **Auto-continue** — Let eligible turns advance on their own; when a turn cannot continue, it stops and waits for you. * **Agent notifications** — The **Agent completed**, **Agent needs input**, and **Agent failed** toggles, moved here from **General**. They are unavailable while the **System notifications** master switch is off. * **Remembered runtime** / **Auto-continue defaults** — Clear remembered choices. ## Terminal Set the default shell and the starting directory for new terminals (**Worktree** / **Project** / **Current file**). * The default shell can be picked from the shells detected on your system, or you can specify a custom path. * Open terminals do not move when you change this preference. * The scrollback buffer is fixed at 10000 lines and is not configurable. ## Shortcuts All rebindable shortcuts, their default keys, and their groups are listed in the [shortcuts reference](/docs/en/reference/shortcuts). Here you can change them one by one, **Reset** a single shortcut, or **Reset all** to restore every default. Conflicting key bindings are rejected with **Shortcut is invalid or already in use**. ## Data & Diagnostics Shows local storage usage broken down by category (database, sessions, terminals, attachments, diagnostics, Agent installations) and offers a cleanup entry point for each: | Action | Effect | | ---------------------------------- | ---------------------------------------------- | | **Clear sessions and attachments** | Deletes session and attachment records. | | **Clear terminal data** | Deletes terminal metadata. | | **Clear diagnostic data** | Deletes diagnostic data. | | **Open data directory** | Opens the data directory in your file manager. | | **Open Usage** | Jumps to usage statistics. | | **Open Management Center** | Jumps to the Config Center. | These cleanup operations are **destructive** and cannot be rolled back. Read [Privacy and recovery](/docs/en/privacy-and-recovery) before you run them. ## About Shows the current **version** and **channel** (Preview / ReleaseCandidate / Stable), platform information, and license, and offers: * **Software update** — Update status and action buttons (**Check now** / **Download** / **Install update** / **Restart now** / **Open release** / **Retry**). Update manifests are signature-verified; a build that fails verification is never installed. The card also lists **Latest version**, **Published**, and **Download size**, and renders that release's notes as Markdown under **What's new in Vibex**; with nothing newer available it shows the installed version's notes instead. * **Environment summary** — Copyable, non-sensitive environment information. Include it when you report a problem. * **Source code** / **Release notes** — Links to the repository and release notes. When you report a problem, include the version, channel, platform, and structured error code, but not full logs.