> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings overview, General and Appearance

> The Settings sections and the document for each, plus the options in General (default permission, messages sent mid-turn, language, keep in the menu bar, auto-archive) and Appearance (theme, display mode).

**Settings** brings together the configuration for your account, notifications, appearance, integrations and workspace. This page first lists where each section is documented, then covers the **General** and **Appearance** sections.

## Availability

| Platform | Support | Notes |
| - | - | - |
| Desktop app | Supported | |
| Web app | Supported | The **General** page has no menu bar option and no updates. See [Differences between the web app and desktop app](#web-vs-desktop) below |
| Mobile web | Partial | Settings use a category list that opens details, and there is no **Keyboard shortcuts** section |

## Where to find it

* Account menu (the avatar at the bottom of the icon bar) › **Settings**, shortcut `⌘,` (Windows: `Ctrl+,`).
* In the command menu `⇧⌘P` (Windows: `Ctrl+Shift+P`), search for **Settings · section name** to jump straight to a section.
* Settings entries on other pages open the matching section directly, for example the gear **Notification settings** in the upper-right corner of the in-app notifications list.

## Settings page layout

The left side of the Settings page is the section navigation (you can search section names at the top), and the right side shows the current section. The navigation has three groups: **Personal**, **Integrations** and **Workspace**:

| Group | Section | Contents and details |
| - | - | - |
| Personal | Account | Profile, Plus, model sources, billing history. See [Account](https://docs.aihubmix.com/en/cloud/settings/account.md) |
| Personal | General | This page. For system notifications, see [Notifications](https://docs.aihubmix.com/en/cloud/settings/notifications.md); for updates, see [Updates](https://docs.aihubmix.com/en/cloud/settings/updates.md) |
| Personal | Notifications | In-app notifications list. See [Notifications](https://docs.aihubmix.com/en/cloud/settings/notifications.md) |
| Personal | Appearance | This page |
| Personal | Keyboard shortcuts | Shortcut reference. See [Keyboard shortcuts](https://docs.aihubmix.com/en/cloud/interface/keyboard-shortcuts.md) |
| Personal | Usage | See [Usage and billing](https://docs.aihubmix.com/en/cloud/settings/usage-and-billing.md) |
| Personal | Security | Sign-in method, sign out. See [Security](https://docs.aihubmix.com/en/cloud/settings/security.md) |
| Integrations | Connectors | See [Connectors](https://docs.aihubmix.com/en/cloud/integrations/connectors.md) |
| Integrations | Plugins | See [Plugins, MCP and Skills](https://docs.aihubmix.com/en/cloud/integrations/plugins-mcp-skills.md) |
| Integrations | Import sessions | See [Messages and session actions](https://docs.aihubmix.com/en/cloud/sessions/messages.md) |
| Workspace | Overview, Secrets & variables, Projects | See [Workspace](https://docs.aihubmix.com/en/cloud/settings/workspace.md) |
| Workspace | Machines | See [Run environment](https://docs.aihubmix.com/en/cloud/projects/run-environment.md) |
| Workspace | Archived chats | See [Archive](https://docs.aihubmix.com/en/cloud/settings/archived.md) |

### Leaving Settings

* **Desktop app**: click another entry in the icon bar or a session in the sidebar.
* **Web app (wide screen)**: click the back arrow at the top of the navigation, or press `Esc`.
* **Mobile web**: after you open a section, **Back to settings** in the upper-left corner returns to the list.

## General

**Settings › General** is divided, from top to bottom, into: Permissions, Chat, General, System notifications and Updates (desktop app only). Changes save as soon as you select them.

### Permissions: default permission on this computer

**Default permission on this computer** sets the permission that sessions running **on your device** start with.

| Option | Meaning |
| - | - |
| Ask for approval | The agent asks you before performing actions that require authorization |
| Approve for me | The system approves routine actions automatically based on rules |
| Full access (default) | No more per-action prompts |

* Sessions on a **cloud server** use full access by default and are not affected by this setting.
* You can adjust the permission for each session in the composer. This does not change the default here.
* When you switch to **Full access**, you are asked to confirm first: once on, the agent runs commands without asking for approval and can read all of this project's secrets.

### Chat: messages sent mid-turn

If you send another message while the agent is running, it is handled according to the default here:

| Option | Default behavior | When sending |
| - | - | - |
| Queue (default) | Sent in order after the current turn ends | You can switch individual messages to steer |
| Steer | Inserted into the current turn immediately | You can switch individual messages to queue |

Only Claude Code and Codex support steering. Other Harnesses queue messages automatically. For per-message choices while running, see [Composer](https://docs.aihubmix.com/en/cloud/sessions/composer.md).

### General

| Setting | Options and default | Notes |
| - | - | - |
| Language | 简体中文 / English | Takes effect immediately. If you have not chosen one, it follows the system language: Simplified Chinese when the system is Chinese, English otherwise |
| Keep in the menu bar | Switch, on by default; desktop app only | On Windows it is called **Keep in the notification area** |
| Archive inactive chats | Never (default) / After 7 days / After 30 days | A workspace-level setting. For the rules, see [Archive](https://docs.aihubmix.com/en/cloud/settings/archived.md) |

* You can also switch the **language** from account menu › **Language**, or with **Switch language to English / 简体中文** in the command menu.
* When **Keep in the menu bar** is on, the app keeps running in the background after you close the main window and shows system notifications as usual. Click the icon in the menu bar (Windows: notification area) to reopen the window. To quit completely: on macOS, use `⌘Q`; on Windows, use Exit in the **File** menu (press `Alt` to show the menu bar).

### System notifications

The **System notifications** group contains the **System notifications** switch, the **System permission** status, and three alert types: **Task completed**, **Needs your attention** and **Task issues**. See [Notifications](https://docs.aihubmix.com/en/cloud/settings/notifications.md).

### Updates

The **Updates** group appears only in the desktop app. It contains two switches, **Automatically check for updates** and **Automatically download updates**, and the version status. See [Updates](https://docs.aihubmix.com/en/cloud/settings/updates.md).

## Appearance

**Settings › Appearance**: first choose a **theme**, then choose a **display mode** (light or dark). The two are independent: for example, if the current setting is **Warm Sand + Dark** and you select **Iris Slate**, it becomes **Iris Slate + Dark**. Changes take effect immediately.

Appearance and notification preferences are saved only on the current device (or this browser). On another device, you need to set them again.

### Themes

| Theme | Light version | Dark version |
| - | - | - |
| Midnight (default) | Soft White | Graphite |
| Warm Sand | Limestone | Ink Green |
| Iris Slate | Chalk | Smoky Violet |

### Display mode

| Option | Effect |
| - | - |
| Light | Always uses the current theme's light version |
| Dark | Always uses the current theme's dark version |
| System (default) | Switches automatically with the operating system's light / dark appearance |

### Other ways to change the appearance

* The Light / Dark / System buttons in the **Appearance** row of the account menu (they switch only the display mode, not the theme).
* The shortcut `⇧⌘L` (Windows: `Ctrl+Shift+L`) cycles through Light → Dark → System.
* Search for **Display mode · name** or **Theme · name** in the command menu.

## Differences between the web app and desktop app

| Item | Desktop app | Web app |
| - | - | - |
| **General › Keep in the menu bar** | Yes | No |
| **General › Updates** and **Check for updates** in the account menu | Yes | No; refreshing the page gives you the latest web app |
| Download the desktop app | None | A **Download the desktop app** card at the top of the account menu |
| Notification permission | Asked once after you complete or skip the sign-in onboarding | Not asked automatically; turn it on in **General › System notifications** when needed |
| **Import sessions** | Can import `.cshare` files and lists Claude Code and Codex sessions on this computer | Can only import `.cshare` files |

## FAQ

### I chose "Steer". Why was my message still queued?

The current session's Harness does not accept messages mid-turn (only Claude Code and Codex do), so the message is queued automatically and sent after the current turn ends.

### Why can't I find "Run environment" or "Sync" in Settings?

These two sections do not exist. You choose whether a session runs on your device or on a cloud server on the new session page and in the session top bar. Devices connected to the workspace are managed in **Settings › Workspace › Machines**. See [Run environment](https://docs.aihubmix.com/en/cloud/projects/run-environment.md).

### Where do auto-archived sessions go?

To **Settings › Workspace › Archived chats**, where you can view, restore or permanently delete them. See [Archive](https://docs.aihubmix.com/en/cloud/settings/archived.md).

## Related

* [Notifications](https://docs.aihubmix.com/en/cloud/settings/notifications.md)
* [Updates](https://docs.aihubmix.com/en/cloud/settings/updates.md)
* [Archive](https://docs.aihubmix.com/en/cloud/settings/archived.md)
* [Composer](https://docs.aihubmix.com/en/cloud/sessions/composer.md)
* [Keyboard shortcuts](https://docs.aihubmix.com/en/cloud/interface/keyboard-shortcuts.md)
* [Account menu and overlays](https://docs.aihubmix.com/en/cloud/interface/command-and-menus.md)
* [Glossary](https://docs.aihubmix.com/en/cloud/concepts/glossary.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.