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

# Overview

> Navigate your global application workspace options, track token usage, and manage core system preferences.

## Your Workspace Hub

The Desktop App serves as the primary control center for managing your local Knowledge Base. While deep backend engine parameters are managed within the primary settings panel, the profile tray in the bottom-left corner provides instant access to account identity, interface styling, usage metrics, and support resources.

***

## 👤 Fast-Access Preferences Tray

Clicking the expand/collapse carets on your user profile badge in the bottom-left corner unfolds a comprehensive system navigation and account maintenance panel.

<Frame caption="The system personalization and quick-access utility drawer opened via the user profile card.">
  <img src="https://mintcdn.com/memverge-1b064d4d/k-hFnzytoNfELtXC/configuration/assets/desktop-config-options.png?fit=max&auto=format&n=k-hFnzytoNfELtXC&q=85&s=96924c9abbc5946837c7ba165c71fe75" alt="MemoryBox desktop profile preferences menu" width="1227" height="715" data-path="configuration/assets/desktop-config-options.png" />
</Frame>

### Preference Panel Elements

| Element             | Description                                                                                                                                                                                            |
| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Usage Telemetry** | A dedicated resource monitor displaying active percentage metrics for monthly compute/token resource consumption, alongside the exact reset date and timestamp for the next automated counter refresh. |
| **Settings**        | Launches the main three-tab dashboard configuration window to manage local data engines, storage locations, and platform models.                                                                       |
| **Theme**           | Provides single-click adjustments to seamlessly shift your desktop layout appearance between **Light**, **Dark**, or **System** styling rules.                                                         |
| **Language**        | Manually overrides interface text string localization, supporting English, 简体中文 (Simplified Chinese), and System Default.                                                                              |
| **Documentation**   | Links out directly to your localized user manuals and developer documentation guide tracks.                                                                                                            |
| **Report an issue** | Opens a standard tracking interface to submit application bugs, console error stacks, or performance logs.                                                                                             |
| **Login / Logout**  | Manages your account identity credentials, secure licensing keys, and cloud synchronization profiles.                                                                                                  |

***

## 🚀 Native Context Onboarding

Selecting the **Getting Started** link from the preferences drawer opens a native platform configuration workspace. This serves as an alternative to the initial conversational thread wizard, providing three explicit, clickable cards to load data into your local environment:

<Frame caption="The native onboarding view providing immediate file, folder, and chat history integration portals.">
  <img src="https://mintcdn.com/memverge-1b064d4d/k-hFnzytoNfELtXC/configuration/assets/desktop-gettingstarted.png?fit=max&auto=format&n=k-hFnzytoNfELtXC&q=85&s=a2efa3eb70de862bb66454858ad3b543" alt="MemoryBox getting started manual workspace view" width="1136" height="880" data-path="configuration/assets/desktop-gettingstarted.png" />
</Frame>

1. **Drop a file:** A localized zone supporting direct drag-and-drop actions for files including PDF, DOCX, MD, TXT, and images.
2. **Sync Folder:** A file-system explorer portal to select an entire directory folder for automated bulk ingestion.
3. **Import AI chats:** A specialized historical utility designed to map data archives downloaded from web-based providers (like ChatGPT, Gemini, or Claude).

***

## ⚙️ App Settings Architecture

Clicking the **Settings** selection within the panel exposes a centralized configuration suite. This layout separates parameters into three discrete, easy-to-use tabs:

<CardGroup cols={3}>
  <Card title="General" icon="sliders" href="/configuration/desktop-general">
    Manage your profile identity, launch states, application behaviors, and custom global keyboard shortcut rules.
  </Card>

  <Card title="Memories" icon="brain-circuit" href="/configuration/desktop-memories">
    Configure your local memory store file directories, indexing properties, and storage destinations.
  </Card>

  <Card title="Advanced" icon="microchip-ai" href="/configuration/desktop-advanced">
    Manage your available model endpoints, API credentials, and specialized AI expert matrices.
  </Card>
</CardGroup>

***

## ℹ️ Version Integrity

Selecting **About MemoryBox** from the profile menu launches an explicit identity card displaying current desktop platform builds.

<Frame caption="The system diagnostic modal tracking current desktop application version metrics.">
  <img src="https://mintcdn.com/memverge-1b064d4d/k-hFnzytoNfELtXC/configuration/assets/desktop-config-about.png?fit=max&auto=format&n=k-hFnzytoNfELtXC&q=85&s=24ff51d182ca2ef0918a3e96ce37446d" alt="About MemoryBox system version modal view" width="1227" height="715" data-path="configuration/assets/desktop-config-about.png" />
</Frame>

This card provides clear traceability by displaying the precise app core version (e.g., `v0.6.22`). It features a **Check for updates** tool that allows you to manually ping distribution networks to verify that your system is running the latest stable build.

***

<Note>
  **The Global Shortcut:** One of the most powerful features found within your General settings is the ability to record a custom global shortcut (defaulting to `Control + Alt + Shift + M`). This configuration binds a system-wide hotkey sequence, ensuring MemoryBox is always one keystroke away regardless of what application you are currently running.
</Note>
