chore(mirror): sync docs from pieces-documentation (26516036415)

public/content/cli.md

@@ -30,7 +30,7 @@ The Pieces CLI offers users a straightforward way to manage and utilize saved co
 </CardGroup>
 
 <Card title="Learn More with Quick Guides" image="/assets/icons/platform_logos/pieces_logo.png">
-  Pieces Quick Guides help you quickly understand and utilize powerful features like the Long-Term (LTM-2.7) Memory Engine and Conversational Search. [Click here to get started.](/products/quick-guides/overview)
+  Pieces Quick Guides help you quickly understand and utilize powerful features like the Long-Term (LTM-2.7) Memory Engine and Conversational Search. [Get started with Quick Guides.](/products/quick-guides/overview)
 </Card>
 
 This software is designed to offer **two main features**: AI Assistance with Conversational Search and material management within the Pieces Drive.

public/content/core-dependencies/ollama/manual-installation.md

@@ -116,4 +116,4 @@ If you no longer need local AI models or wish to remove the Ollama wrapper from
 
 ## Next Steps
 
-You can read documentation about what [local LLMs are currently available](/products/core-dependencies/ollama/supported-models) on Ollama and are supported by PiecesOS, or [click here for troubleshooting](/products/core-dependencies/ollama/troubleshooting) if you’re experiencing installation issue.
+You can read documentation about what [local LLMs are currently available](/products/core-dependencies/ollama/supported-models) on Ollama and are supported by PiecesOS, or the [Ollama troubleshooting guide](/products/core-dependencies/ollama/troubleshooting) if you’re experiencing installation issue.

public/content/core-dependencies/on-device-storage.md

@@ -15,19 +15,22 @@ Pieces stores and processes everything on your device by default—code snippets
 **When data can move to the cloud:** Only when you explicitly enable **Personal Cloud** or use a cloud-based model provider (OpenAI, Anthropic, Google). In those cases, data is handled by the provider's privacy policy.
 
 <Callout type="tip">
-  We're **SOC 2 Type II** certified and never use your data to train models. You can delete everything at any time by removing the `com.pieces.os` folder.
+  We're **SOC 2 Type II** certified and never use your data to train models. You can delete everything at any time by removing the `com.pieces.os` and `com.pieces.pfd` folders from your Library (macOS) or equivalent paths on other platforms.
 </Callout>
 
 ## Where Your Database Lives
 
 | **Platform** | **Default path** |
 | --- | --- |
 | *macOS* | `/Users/<username>/Library/com.pieces.os/` |
-| *Windows* | `C:/Users/<username>/Documents/com.pieces.os/` |
+| *Windows (PiecesOS)* | `C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\` |
+| *Windows (Desktop App)* | `C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\` |
 | *Linux* | `/home/<username>/.local/share/com.pieces.os/` |
 
 Inside `com.pieces.os`, the `production` folder contains your LTM-2.7 context and all other Pieces data. You can **copy**, **compress**, or **relocate** this folder to sync via OneDrive or migrate to another machine.
 
+The Pieces Desktop App stores additional data in a separate `com.pieces.pfd` folder (`~/Library/com.pieces.pfd/` on macOS, or `...\Pieces for Developers\com.pieces.pfd\` on Windows). For a full backup, copy both folders from their respective parent directories on Windows.
+
 <Callout type="tip">
   Replace `<username>` with your OS account name.
 </Callout>
@@ -38,13 +41,30 @@ When opening a GitHub issue or contacting support, attaching recent logs helps d
 
 | **Platform** | **Log path** |
 | --- | --- |
-| *macOS* | `/Users/<username>/Library/com.pieces.os/production/support/logs/` |
-| *Windows* | `C:/Users/<username>/Documents/com.pieces.os/production/support/logs` |
+| *macOS (PiecesOS)* | `/Users/<username>/Library/com.pieces.os/production/Support/logs/` |
+| *macOS (Desktop App)* | `/Users/<username>/Library/com.pieces.pfd/production/logs/` |
+| *Windows (PiecesOS)* | `C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Support\` |
+| *Windows (Desktop App)* | `C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\production\logs\` |
 | *Linux* | `/home/<username>/.local/share/com.pieces.os/logs/` |
 
-Logs rotate daily and are timestamped (e.g., `log-05062025`). Zip the latest two or three files and attach them to your <a target="_blank" href="https://github.com/pieces-app/support/issues">GitHub issue</a> or Discord DM.
+<Callout type="tip">
+  On Windows, if `AppData` is hidden in File Explorer, enable `View` → `Show` → `Hidden items`. You can also press `Win+R` and paste the path above. PiecesOS and the Desktop App use different parent folders under `Mesh Intelligent Technologies, Inc\`.
+</Callout>
+
+Zip the latest two or three log files from the path above and attach them to your <a target="_blank" href="https://github.com/pieces-app/support/issues">GitHub issue</a> or Discord DM.
+
+## Backup & Restore
 
-## Create a Manual Backup
+Pieces supports two backup approaches. Use **manual folder backup** for a full copy of your on-device database (including Long-Term Memory). Use **Personal Cloud backup** for snapshots of app data you can restore from the Desktop App on any device where you're signed in.
+
+| Method | Best for | Requires |
+| --- | --- | --- |
+| **Manual folder backup** | Full LTM database, migration, offline archives | Quitting Pieces, copying `com.pieces.os` (and `com.pieces.pfd`) |
+| **Personal Cloud backup** | Snippets, Drive files, settings, chat history | Connected [Personal Cloud](/products/desktop/configuration/account#personal-cloud) |
+
+### Manual Backup
+
+Copy your on-device database folders directly. This is the most complete option if you need everything in `production`, including Long-Term Memory context.
 
 <Steps>
   <Step title="Quit all Pieces apps">
@@ -54,28 +74,74 @@ Logs rotate daily and are timestamped (e.g., `log-05062025`). Zip the latest two
   <Step title="Copy the database folder">
     Copy the entire `com.pieces.os` folder to your backup location (USB, NAS, or cloud storage):
 
-    * **macOS:** `/Users/<username>/Library/com.pieces.os/`
-    * **Windows:** `C:/Users/<username>/Documents/com.pieces.os/`
+    * **macOS:** `/Users/<username>/Library/` (copy both `com.pieces.os` and `com.pieces.pfd`)
+    * **Windows:** Copy `...\Pieces OS\com.pieces.os\` and `...\Pieces for Developers\com.pieces.pfd\` from `C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\`
     * **Linux:** `/home/<username>/.local/share/com.pieces.os/`
   </Step>
 </Steps>
 
+### Backup via Personal Cloud
+
+Create a snapshot from the Pieces Desktop App. Backups are stored in your personal Pieces Cloud and can be restored or deleted from the same modal.
+
+<Steps>
+  <Step title="Open Account Settings">
+    Click your `User Profile` in the top left, then hover over `Settings` and select `Account`.
+  </Step>
+
+  <Step title="Open Backup & Restore Data">
+    Scroll to the *Personal Cloud* section. In *Backup & Restore Data*, click the `Restore Icon` (circular arrow) to open the modal.
+  </Step>
+
+  <Step title="Create Backup">
+    In the *Create Backup* section, click the `Cloud Icon with Upward Arrow` to upload a new backup to your personal Pieces Cloud.
+  </Step>
+</Steps>
+
+Cloud backups include snippets, Pieces Drive files, user preferences, Conversational Search data, search and tagging data, and linked account connections (without passwords). They do not replace a full manual copy of your `com.pieces.os` database if you need to preserve raw Long-Term Memory data.
+
+<Callout type="info">
+  For the full backup workflow, including what's included, viewing backups, and deleting old snapshots, see [Backup & Restore Data](/products/desktop/configuration/account#backup--restore-data) in Account settings.
+</Callout>
+
 ## Restore on a New Machine
 
+### Restore a Manual Backup
+
+Use this when you copied `com.pieces.os` (and optionally `com.pieces.pfd`) to another drive or machine.
+
 <Steps>
   <Step title="Install PiecesOS">
     Install PiecesOS on the new machine via the [Pieces Desktop App](/products/desktop/onboarding) or [manual installation](/products/core-dependencies/pieces-os/manual-installation).
   </Step>
 
   <Step title="Replace the database folder">
-    Replace the newly created `com.pieces.os` folder with your backup.
+    Replace the newly created `com.pieces.os` folder with your backup. Also restore `com.pieces.pfd` if you backed it up.
   </Step>
 
   <Step title="Restart Pieces">
     Relaunch PiecesOS and the Pieces Desktop App.
   </Step>
 </Steps>
 
+### Restore a Personal Cloud Backup
+
+Use this when you created a backup through *Backup & Restore Data* in Account settings.
+
+<Steps>
+  <Step title="Connect Personal Cloud">
+    On the target machine, open `Settings` → `Account`, scroll to *Personal Cloud*, and connect your cloud if you are not already signed in.
+  </Step>
+
+  <Step title="Open Backup & Restore Data">
+    In the *Personal Cloud* section, click the `Restore Icon` in *Backup & Restore Data* to open the modal.
+  </Step>
+
+  <Step title="Select and Restore">
+    In the *Backups* list, find the snapshot you want, then click the `Restore Icon` on that entry and confirm when prompted.
+  </Step>
+</Steps>
+
 ## Start Fresh (Reset)
 
 <Steps>
@@ -94,6 +160,12 @@ Logs rotate daily and are timestamped (e.g., `log-05062025`). Zip the latest two
 
 ***
 
+## Next Steps
+
+* [Long-Term Memory settings](/products/desktop/configuration/long-term-memory) — clear stored data, app access, and permissions.
+* [Account settings](/products/desktop/configuration/account#backup--restore-data) — Personal Cloud backup and restore.
+* [Support](/products/support) — report issues and find platform log paths.
+
 ## Need Help?
 
 Open a GitHub issue for PiecesOS, the Pieces Desktop App, or any MCP integration at <a target="_blank" href="https://github.com/pieces-app/support/issues">our GitHub repository</a>.

public/content/core-dependencies/pieces-os.md

@@ -13,9 +13,7 @@ ogImage: "https://storage.googleapis.com/hashnode_product_documentation_assets/o
 
 **PiecesOS** is a background service that runs on your machine. It orchestrates local data processing, manages on-device machine learning models, and serves as the bridge between your workflow and every Pieces product—including the [Pieces Desktop App](/products/desktop/onboarding), [MCP integrations](/products/mcp), and the [CLI](/products/cli).
 
-<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_dependencies_assets/figma_mockups/piecesos_bridging_all_products.png" alt="PiecesOS bridging all Pieces products and services" align="center" fullwidth="true" />
-
-> PiecesOS bridging all Pieces products and services
+<piecesos-bridge-diagram />
 
 ## What PiecesOS Does
 

public/content/core-dependencies/pieces-os/long-term-memory.md

@@ -42,7 +42,7 @@ The agent decides what to access based on your question. You don't need to confi
 
 ### What This Enables
 
-The agentic foundation powers features like [Meeting Prep](/products/desktop/single-click-summaries/default-types#meeting-prep) (summaries that take action on your behalf), [Reflection Mode](/products/desktop/conversational-search/using-conversational-search#reflection-mode) (metacognition for the agent), and deeper multi-step investigations in chat.
+The agentic foundation powers features like [Meeting Prep](/products/desktop/single-click-summaries/default-types#meeting-prep) (summaries that take action on your behalf), [Reflection Mode](/products/desktop/conversational-search#reflection-mode) (metacognition for the agent), and deeper multi-step investigations in chat.
 
 ***
 

public/content/core-dependencies/pieces-os/troubleshooting.md

@@ -162,24 +162,23 @@ An outdated operating system can prevent PiecesOS from running. Minimum requirem
 
 ## Windows: Controlled Folder Access
 
-If you've enabled Controlled Folder Access (CFA), PiecesOS may fail to launch because it writes data to the Documents folder. Add the PiecesOS executable path to your CFA allowlist, or disable CFA if it's not required.
+If you've enabled Controlled Folder Access (CFA), PiecesOS may fail to launch if Windows blocks writes under AppData. Add the PiecesOS executable to your CFA allowlist, or disable CFA if it's not required.
 
 ## Finding Pieces Logs
 
-Attach recent logs when opening a GitHub issue or contacting support—it helps diagnose problems in minutes.
+Attach recent logs when opening a GitHub issue or contacting support. It helps diagnose problems in minutes.
 
-**PiecesOS logs:**
+See [Finding Your Logs](/products/core-dependencies/on-device-storage#finding-your-logs) for the full path table, or use these quick references:
 
-| **Platform** | **Path** |
+| **Platform** | **PiecesOS logs** |
 | --- | --- |
-| *macOS* | `/Users/<username>/Library/com.pieces.os/production/support/logs/` |
-| *Windows* | `C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\` |
+| *macOS* | `/Users/<username>/Library/com.pieces.os/production/Support/logs/` |
+| *Windows* | `C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Support\` |
 | *Linux* | `/home/<username>/.local/share/com.pieces.os/logs/` |
 
-**Pieces Desktop logs (Windows):**
-```
-C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces Desktop\com.pieces.os\production\
-```
+**Desktop App logs (Windows):** `C:\Users\<username>\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces for Developers\com.pieces.pfd\production\logs\`
+
+**Desktop App logs (macOS):** `/Users/<username>/Library/com.pieces.pfd/production/logs/`
 
 <Callout type="tip">
   Replace `<username>` with your OS account name. Zip the latest two or three log files and attach them to your <a target="_blank" href="https://github.com/pieces-app/support/issues">GitHub issue</a>.

public/content/desktop.md

@@ -80,7 +80,7 @@ Use [Conversational Search](/products/desktop/conversational-search) as your mai
 
 ## Configuration
 
-Customize your Pieces Desktop App experience through *Settings*, which includes options for Account (with Personal Cloud and Telemetry), Long-Term Memory, Models, Copilot Chats, Machine Learning, Model Context Protocol (MCP), Connected Applications, Views & Layouts, Appearance, and Troubleshooting.
+Customize your Pieces Desktop App through *Settings*: **Account** (profile, Personal Cloud, backup, telemetry), **Long-Term Memory**, **MCP**, **Connectors**, **Appearance**, and **Troubleshooting**. Choose models from the Conversational Search chat picker; see [Models in chat](/products/desktop/conversational-search/models) for cloud vs local selection.
 
 <FancyCard title="Learn More" href="/products/desktop/configuration" colored={false}>
   Explore all configuration options to customize your Pieces Desktop experience.

public/content/desktop/configuration.md

@@ -13,8 +13,8 @@ metaDescription: Customize Pieces with settings for visuals, Pieces Timeline enr
 Open Settings from the home view to adjust account and cloud behaviors, check your application versions, change views and layouts, and more.
 
 <Steps>
-  <Step title="Click Profile Picture">
-    Click your profile picture in the top left of the home view.
+  <Step title="Open User Profile">
+    Click your `User Profile` in the top left of the home view.
 
     <Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/desktop/configuration/settings_dropdown_open.png" alt="Profile menu open with Settings and quick category options" align="center" fullwidth="true" />
   </Step>
@@ -24,7 +24,7 @@ Open Settings from the home view to adjust account and cloud behaviors, check yo
   </Step>
 
   <Step title="Choose Navigation Method">
-    You can either select one of the quick options (Account, Long-Term Memory, Models, MCP, Appearance, Troubleshooting) to jump directly to that category, or select `All` at the top of the quick options to open the full Settings view with all categories. You can also select `Log Out` at the bottom of the menu to sign out of your account.
+    You can either select one of the quick options (Account, Long-Term Memory, MCP, Connectors, Appearance, Troubleshooting) to jump directly to that category, or select `All` at the top of the quick options to open the full Settings view with all categories. You can also select `Log Out` at the bottom of the menu to sign out of your account.
   </Step>
 
   <Step title="Understand the Layout">
@@ -79,16 +79,16 @@ Manage long-term memory preferences and data. Configure the Long-Term Memory Eng
   Configure the Long-Term Memory Engine, manage app access control, system permissions, and optimize performance.
 </FancyCard>
 
-## Models
+## Connectors
 
-Manage AI models and model preferences. Configure processing modes, set up local model runtime with Ollama, and control which AI models are available for use in Pieces.
+Link external services such as Google Calendar so Pieces can read calendar context and take actions on your behalf. Manage connections from the Connectors tab in Settings.
 
-<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/desktop/configuration/models/models_settings_overview.png" alt="Models settings with capabilities, local runtime, and model management" align="center" fullwidth="true" />
+<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/desktop/connectors/connectors_settings_pane.png" alt="Connectors settings showing Google Calendar and upcoming integrations" align="center" fullwidth="true" />
 
-> Models settings showing Model Capabilities, Local Model Runtime, and Model Management sections
+> Connectors settings showing connected and available integrations
 
-<FancyCard title="Learn More" href="/products/desktop/configuration/models" colored={false}>
-  Configure processing modes, set up Ollama for local models, and enable or disable specific AI models.
+<FancyCard title="Learn More" href="/products/desktop/connectors" colored={false}>
+  Connect Google Calendar, authorize services, and learn how calendar context appears in summaries.
 </FancyCard>
 
 ## Model Context Protocol (MCP)

public/content/desktop/configuration/long-term-memory.md

@@ -260,8 +260,8 @@ Remove persisted data captured by the Long-Term Memory Engine. You can scope del
     Click your `User Profile` in the top left, then hover over `Settings` and select `Long-Term Memory`.
   </Step>
 
-  <Step title="Open Manage Data">
-    In the *Stored Data* section, click `Manage Data` to open the data management panel.
+  <Step title="Open Clear Long-Term Memory Data">
+    In the *Stored Data* section, click `Clear Long-Term Memory Data...` to open the data management panel.
   </Step>
 
   <Step title="Select Time Range">