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

> Every item in Settings by section: what it does, its default, and how to change it, plus where to find sections that have their own pages.

**Settings** holds the configuration for your account, notifications, appearance, integrations, and workspace. Press `⌘,` (Windows: `Ctrl+,`) or click **Settings** in the account menu to open it. In the command menu `⇧⌘P` (Windows: `Ctrl+Shift+P`), search for "Settings" plus a section name to jump straight to that section. Changes save immediately.

> [!NOTE]
>
> In the mobile web app, you pick a category first and then open its details, and there is no Keyboard shortcuts section. The web app does not have the Keep in the menu bar and Updates items.

## Personal

### Account, Usage, Security

* **Account**: profile, Plus, model sources, billing history, and deleting workspace data. See [Account and security](https://docs.aihubmix.com/en/cloud/account/account-and-security.md).
* **Usage**: tokens and estimated spend for model calls. See [Plus plan and usage](https://docs.aihubmix.com/en/cloud/account/plus.md).
* **Security**: sign-in method and sign out. See [Account and security](https://docs.aihubmix.com/en/cloud/account/account-and-security.md).

### General

| Setting | Default | Description |
| - | - | - |
| Default permission on this computer | Full access | The permission a session uses when it starts running on your device: Ask for approval, Approve for me, or Full access. Switching to Full access requires confirmation. Sessions on the cloud server always use Full access. You can also change it for each session in the composer. See [Start a session](https://docs.aihubmix.com/en/cloud/sessions/start-a-session.md) |
| Messages sent mid-turn | Queue | How messages you send while the agent is running are handled. Queue: sent in order after the current task ends. Steer: handed to the working agent right away. Only Claude Code and Codex support Steer. Others fall back to Queue automatically. See [Work with the agent](https://docs.aihubmix.com/en/cloud/sessions/work-with-agent.md) |
| Language | System | Simplified Chinese or English. Changes take effect immediately. If you have never chosen one, the app uses Simplified Chinese when your system language is Chinese, and English otherwise |
| Keep in the menu bar | On | Desktop app only (on Windows, this is the notification area). When on, closing the main window leaves the app running in the background and showing notifications as usual. To quit completely, press `⌘Q` on macOS, or use Exit in the File menu on Windows |
| Archive inactive chats | Never | You can choose After 7 days or After 30 days. Applies to the whole workspace. Running sessions are never archived |

### System notifications

In the System notifications group of **Settings › General**.

| Setting | Default | Description |
| - | - | - |
| System notifications | On | Master switch. When off, no banners appear, and your choices for the three categories below are kept |
| System permission | None | Shows whether your system or browser allows notifications. If not yet requested, click **Allow notifications**. If denied, click **System Settings** |
| Task completed | On | A session or scheduled task finished |
| Needs your attention | On | Needs your approval, more information, or manual action |
| Task issues | On | A failure, an interruption, or a scheduled task that was paused automatically |

Banners appear only when you are not viewing the related page at the time. Click a banner to open the related session or scheduled task. The desktop app asks for notification permission once after your first sign-in. The web app does not ask automatically, so turn it on here. Whether a scheduled task notifies you of its result also depends on its own notification settings. See [Scheduled tasks](https://docs.aihubmix.com/en/cloud/automation/scheduled-tasks.md).

### Notifications

The in-app notification list. It is independent of the system notification switches, and records are kept even when system notifications are off. You can also open it with `⌥⌘U` (Windows: `Ctrl+Alt+U`) or from **Notifications** in the account menu. Filter by All or Unread, click **Mark all read**, or click an item to open the related session, scheduled task, or project. Read status syncs across your devices.

### Appearance

| Setting | Default | Description |
| - | - | - |
| Theme | Midnight | Warm Sand and Iris Slate are also available. Each theme has a light and a dark version |
| Display mode | System | Light, Dark, or System. Independent of the theme |

Press `⇧⌘L` (Windows: `Ctrl+Shift+L`) or use the appearance row in the account menu to switch display mode quickly. This does not change the theme. Appearance and notification preferences are saved only on the current device or browser.

### Updates

Desktop app only, in the Updates group of **Settings › General**. In the web app, refreshing the page gives you the latest version.

| Setting | Default | Description |
| - | - | - |
| Automatically check for updates | On | When off, the app does not look for new versions, and automatic downloads are also unavailable |
| Automatically download updates | On | Downloads new versions in the background and prompts you to restart when done |

You can also click **Check for updates** in the account menu to check manually. After the download finishes, click **Restart to update**. If local tasks are still running on this computer, you can choose **Restart after tasks** to restart automatically when they finish. Cloud sessions are not affected by restarting.

### Keyboard shortcuts

Lists every shortcut, with the same content as the `⌘/` quick reference panel. See [Keyboard shortcuts](https://docs.aihubmix.com/en/cloud/reference/keyboard-shortcuts.md).

## Integrations

* **Connectors**: authorization for services such as GitHub and Gmail. See [Connectors](https://docs.aihubmix.com/en/cloud/integrations/connectors.md).
* **Plugins**: plugins, MCP, and Skills. See [Plugins, MCP, and Skills](https://docs.aihubmix.com/en/cloud/integrations/plugins-mcp-skills.md).
* **Import sessions**: import sessions from other tools or other accounts and continue them. The original sessions are not affected. Click **Import from .cshare file** to choose a file (up to 50 MB). The desktop app also lists Claude Code and Codex sessions on this computer. Select them and click **Import**. Sensitive information is removed from session records on your device before import, and there is a daily import limit.

## Workspace

| Section | Contents |
| - | - |
| Overview | Workspace name (1 to 64 characters), project count and members, and the cloud server admin permission switch (on by default; when on, the agent can install software and change system settings on the cloud server). See [Cloud server](https://docs.aihubmix.com/en/cloud/environments/cloud-host.md) |
| Machines | Computers signed in to the desktop app and your cloud server, plus whether each computer allows runs, its permission limit, and which secrets it can use. See [Run on your device](https://docs.aihubmix.com/en/cloud/environments/your-device.md) |
| Secrets & variables | Variables and secrets for a single project or shared by all projects. When names match, the project value takes priority. Add them one at a time, or use **Bulk add** to paste `.env` contents. Secrets are stored encrypted, and AI cannot see the original values. See [Projects and environments](https://docs.aihubmix.com/en/cloud/environments/projects.md) |
| Projects | All projects in the workspace. Click the gear at the end of a row to open project settings. See [Projects and environments](https://docs.aihubmix.com/en/cloud/environments/projects.md) |
| Archived chats | Archived sessions. You can open and view them, **Restore** them to the sidebar, or delete them permanently. See [Manage sessions](https://docs.aihubmix.com/en/cloud/sessions/manage-sessions.md) |


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