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

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/cloud-services-deprecation.md

@@ -0,0 +1,64 @@
+---
+title: "Update Required for Cloud Services"
+path: /core-dependencies/pieces-os/cloud-services-deprecation
+visibility: PUBLIC
+status: PUBLISHED
+description: "Action required by Friday, June 5th 2026: cloud services for PiecesOS versions prior to 12.4.0 will be deprecated. Update before that date to continue using Chat, Work Summaries, and Single Click Summaries."
+metaTitle: "Update Required for Cloud Services | PiecesOS"
+metaDescription: Cloud services for PiecesOS versions prior to 12.4.0 will be deprecated on Friday, June 5th 2026. Update to 12.4.0 or later to continue using Chat, Work Summaries, and Single Click Summaries.
+---
+
+## Summary
+
+On Friday, June 5th 2026, we will be deprecating cloud services for all PiecesOS versions prior to 12.4.0. If you are running an older version of PiecesOS, you will need to update to 12.4.0 or later before that date to continue using cloud-backed features.
+
+## Who is Affected
+
+You are affected if your PiecesOS version is lower than 12.4.0.
+
+To check your version:
+
+* **Desktop App**: `Settings` → `About` → *PiecesOS Version*
+
+## What Will Stop Working After June 6th, 2025
+
+On deprecated versions, the following features will no longer function and will return an error:
+
+* **Chat** — conversations, follow-ups, and any model-backed responses will fail
+* **Work Summaries** — will fail to generate
+* **Single Click Summaries** — will fail to generate
+
+All other functionality (local features, account access, etc.) will continue to work as expected.
+
+## What You Need to Do
+
+Update PiecesOS to 12.4.0 or later before Friday, June 5th 2026. This is the only required action.
+
+### Recommended: Update from the Pieces Tray Icon
+
+On all operating systems, the easiest way to update is directly from the Pieces icon in your system tray / toolbar. Click the Pieces icon, and PiecesOS will check for updates automatically — if a new version is available, you can install it from there.
+
+### Alternative: Update from Inside the Desktop App
+
+You can also trigger the update from within the Pieces Desktop App by opening the user menu in the top-left and selecting `Check for Updates`.
+
+### Other Install Methods
+
+* **Homebrew (macOS/Linux)**: `brew upgrade pieces-os`
+* **Manual installs**: follow the [manual installation guide](/products/core-dependencies/pieces-os/manual-installation)
+
+After updating, restart PiecesOS and verify your version is 12.4.0 or higher.
+
+## Why We Are Making This Change
+
+Older PiecesOS versions were built against legacy cloud infrastructure that we are retiring in favor of our new agentic engine and updated backend. Maintaining backward compatibility with the old infrastructure was holding back security, reliability, and the ability to ship improvements to Chat and the broader product.
+
+## Need Help?
+
+If you run into trouble updating, or if updating doesn't resolve your issue:
+
+* Open a new issue in this repository with your PiecesOS version, OS, and a description of what you're seeing
+* Or email us directly at [support@pieces.app](mailto:support@pieces.app)
+* Or book a quick [support call](https://calendar.google.com/calendar/u/0/appointments/schedules/AcZssZ3bJHPPSJJHom2WwsPf5KcNlu-vRZsVa3DO1gJ7q4VIwExD1NUFBXlc7w8JGnEoSd2TLxP3eFbh)
+
+Thanks for being part of the Pieces community.

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.