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

public/content/cli/configuration.md

@@ -18,7 +18,7 @@ Pick which cloud model powers `ask`, set the editor that opens your config file,
 
 ## Available Models
 
-The Pieces CLI uses the same models as the rest of the Pieces Suite. Choose from four model families—**Claude**, **Gemini**, **Grok**, and **ChatGPT**—each available in Fast, Balanced, and Extra Thinking modes. Every family and mode is available on both Free and Pro.
+The Pieces CLI uses the same models as the rest of the Pieces Suite. Choose from three model families—**Claude**, **Gemini**, and **ChatGPT**—each available in Fast, Balanced, and Extra Thinking modes.
 
 For deeper guidance on picking the right model, see [LLM Settings](/products/cli/copilot/llms-settings) and [Choose a Model](/products/desktop/conversational-search/models).
 

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

@@ -31,7 +31,7 @@ The agent reasons across your memory in multiple turns, following threads, cross
 
 ### AI Models
 
-PiecesOS coordinates AI model requests for all Pieces products. Choose from four model families—Claude, Gemini, Grok, and ChatGPT—each available in Fast, Balanced, and Extra Thinking modes. See [Choose a Model](/products/desktop/conversational-search/models) to pick a family and mode.
+PiecesOS coordinates AI model requests for all Pieces products. Choose from three model families—Claude, Gemini, and ChatGPT—each available in Fast, Balanced, and Extra Thinking modes. See [Choose a Model](/products/desktop/conversational-search/models) to pick a family and mode.
 
 ### MCP Support
 

public/content/desktop/configuration/models.md

@@ -2,7 +2,7 @@
 title: Models
 path: /desktop/configuration/models
 visibility: PRIVATE
-status: PUBLISHED
+status: DRAFT
 description: Manage AI models and model preferences.
 metaTitle: Models Settings in Pieces Desktop
 metaDescription: Manage AI models, configure processing modes, set up local model runtime, and enable or disable specific models.

public/content/desktop/conversational-search.md

@@ -72,7 +72,7 @@ To scope a chat to **one** Timeline Event or summary, open that item in Timeline
 </FancyCard>
 
 <FancyCard title="Choose a Model" href="/products/desktop/conversational-search/models" colored={false}>
-  Switch between model families—Claude, Gemini, Grok, and ChatGPT—using Fast, Balanced, and Extra Thinking modes.
+  Switch between model families—Claude, Gemini, and ChatGPT—using Fast, Balanced, and Extra Thinking modes.
 </FancyCard>
 
 <FancyCard title="Write Better Prompts" href="/products/desktop/conversational-search/prompting-guide" colored={false}>

public/content/desktop/conversational-search/models.md

@@ -12,11 +12,10 @@ metaDescription: Switch between model families in Pieces and choose Fast, Balanc
 
 Click the `model button` in the bottom toolbar to choose your model. Pieces keeps selection simple: pick a **model family**, then choose a **mode**.
 
-Pieces offers four model families:
+Pieces offers three model families:
 
 * **Claude**
 * **Gemini**
-* **Grok**
 * **ChatGPT**
 
 Each family is available in three modes:
@@ -36,7 +35,7 @@ Each family is available in three modes:
     Click the `model button` in the *bottom toolbar*.
   </Step>
   <Step title="Choose a Family">
-    Hover over **Claude**, **Gemini**, **Grok**, or **ChatGPT**.
+    Hover over **Claude**, **Gemini**, or **ChatGPT**.
   </Step>
   <Step title="Select a Mode">
     Click **Fast**, **Balanced**, or **Extra Thinking** for that family.

public/content/desktop/conversational-search/using-conversational-search.md

@@ -237,7 +237,7 @@ Browse and switch models directly from chat, without navigating to Settings. The
   </Step>
 
   <Step title="Choose a Family">
-    Hover over a model family—**Claude**, **Gemini**, **Grok**, or **ChatGPT**—to see its available modes.
+    Hover over a model family—**Claude**, **Gemini**, or **ChatGPT**—to see its available modes.
   </Step>
 
   <Step title="Choose a Mode">

public/content/meet-pieces/fundamentals.md

@@ -65,7 +65,7 @@ Conversational Search, available in the Pieces Desktop App, any IDE, or browser
 
 * `Content Generation`: Create content based on what you need, either by asking directly or using context from your current work.
 
-* `LLM Flexibility`: Switch between model families—Claude, Gemini, Grok, and ChatGPT—and choose Fast, Balanced, or Extra Thinking modes.
+* `LLM Flexibility`: Switch between model families—Claude, Gemini, and ChatGPT—and choose Fast, Balanced, or Extra Thinking modes.
 
 ## Timeline
 

public/content/meet-pieces/linux-installation-guide/flatpak.md

@@ -16,67 +16,63 @@ Pieces provides its own Flatpak repository hosted at `builds.pieces.app`, which
 
 ### Flatpak Requirements
 
-* **Flatpak Runtime:** Install Flatpak using your distro's package manager. Most distributions include it in their repositories. See [flathub.org/setup](https://flathub.org/setup) for distro-specific instructions.
-* **Flathub Repository:** The Flathub repository provides shared runtime dependencies that Pieces requires. It must be added before installing Pieces.
-* **User Permissions:** The Pieces repository is added with the `--user` flag, so no `sudo` is required for installation.
+* **Flatpak:** Install Flatpak using your distro's package manager. Most distributions include it in their repositories. See [flathub.org/setup](https://flathub.org/setup) for distro-specific instructions.
+* **Installation scope:** Use `--user` for both packages, or omit it for both. Flatpak does not share runtimes across user and system scopes, so mixing them will fail.
+* **User Permissions:** The commands below use `--user`, so no `sudo` is required. Drop `--user` from both install commands if you prefer a system-wide install.
 
-### Install via Flatpak
+### Install via a software center
 
-Follow these steps in order to install Pieces via Flatpak. All commands are run in your terminal.
+Open the PiecesOS `.flatpakref` in GNOME Software, KDE Discover, or another Flatpak-aware software center. That file adds the Pieces repository and the Flathub repository that provides the shared GNOME runtime, then installs PiecesOS.
 
-<Steps>
-  <Step title="Add Flathub Repository">
-    Flathub provides shared runtime dependencies that Pieces requires. If you haven't already added Flathub to your system, run:
+[Install PiecesOS (`.flatpakref`)](https://builds.pieces.app/pieces-flatpak-repo/com.pieces.os.flatpakref)
 
-    ```bash
-    flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
-    ```
+After PiecesOS is installed, open the Desktop App `.flatpakref` the same way:
 
-    This command is safe to run even if Flathub is already configured. It will skip if the repository already exists.
-  </Step>
+[Install Pieces Desktop App (`.flatpakref`)](https://builds.pieces.app/pieces-flatpak-repo/com.pieces.pfd.flatpakref)
 
-  <Step title="Add the Pieces Flatpak Repository">
-    Add the official Pieces Flatpak repository to your system. This repository hosts both PiecesOS and the Pieces Desktop App:
+Do not use the older `pieces-flatpak.flatpakrepo` file on its own. A `.flatpakrepo` file only adds a remote and does not declare the runtime source, so the GNOME runtime may be missing.
 
-    ```bash
-    flatpak remote-add --user --if-not-exists --from pieces-flatpak https://builds.pieces.app/pieces-flatpak-repo/pieces-flatpak.flatpakrepo
-    ```
+### Install via Flatpak
 
-    The `--user` flag installs the repository for your user account only, so no `sudo` is required.
-  </Step>
+Prefer the command line? Run these commands in order.
 
+<Steps>
   <Step title="Install PiecesOS">
-    Install PiecesOS, the local engine that powers all Pieces functionality. PiecesOS runs on-device for speed, privacy, and offline use:
+    Install PiecesOS, the on-device engine that powers everything — Long-Term Memory, local AI, and MCP.
 
     ```bash
-    flatpak install -y pieces-flatpak com.pieces.os
+    flatpak install --user -y --from https://builds.pieces.app/pieces-flatpak-repo/com.pieces.os.flatpakref
     ```
 
-    This may take a few minutes as Flatpak downloads the required runtime dependencies.
+    This adds both the Pieces repository and the Flathub repository that provides the shared GNOME runtime, so no separate setup is needed. It can take a few minutes while Flatpak downloads the runtime. Drop `--user` to install system-wide.
   </Step>
 
   <Step title="Install Pieces Desktop App">
-    Install the Pieces Desktop App, your hub for saving, searching, and managing code snippets, screenshots, and developer resources:
+    Install the Pieces Desktop App, your hub for saving, searching, and managing snippets, screenshots, and developer resources.
 
     ```bash
-    flatpak install -y pieces-flatpak com.pieces.pfd
+    flatpak install --user -y --from https://builds.pieces.app/pieces-flatpak-repo/com.pieces.pfd.flatpakref
     ```
+
+    Use the same scope as the previous command — either `--user` for both, or neither.
   </Step>
 
-  <Step title="Launch Pieces">
-    **Important:** You must start PiecesOS first. It runs as a background service that the Desktop App connects to. The Desktop App will not launch PiecesOS automatically.
+  <Step title="Start PiecesOS">
+    Start PiecesOS first. It runs as a background service the Desktop App connects to, and the app won't launch it automatically.
 
     ```bash
     flatpak run com.pieces.os
     ```
+  </Step>
 
-    Once PiecesOS is running, launch the Pieces Desktop App:
+  <Step title="Launch the Pieces Desktop App">
+    Once PiecesOS is running, launch the Pieces Desktop App. After the first launch, both appear in your application menu.
 
     ```bash
     flatpak run com.pieces.pfd
     ```
 
-    After the first launch, both apps will appear in your application menu. Always launch PiecesOS before the Desktop App.
+    Always start PiecesOS before the Desktop App.
   </Step>
 </Steps>
 
@@ -178,6 +174,14 @@ flatpak permission-reset com.pieces.pfd
 
 Then restart both applications.
 
+**Missing GNOME runtime (`org.gnome.Platform` was not found):**
+
+This happens when Pieces was installed in a different Flatpak scope than Flathub (for example, Flathub as system and Pieces as `--user`). Uninstall both apps, then reinstall from the `.flatpakref` commands above so both remotes are added in the same scope.
+
+```
+error: The application com.pieces.os/x86_64/stable requires the runtime org.gnome.Platform/x86_64/48 which was not found
+```
+
 **Verify the Pieces repository is accessible:**
 
 If installation fails, confirm the Pieces repository is reachable:

public/content/meet-pieces/managing-your-account.md

@@ -78,7 +78,7 @@ Your Pieces account connects your tools and preferences across devices. **Pieces
 
 | Feature | With Pieces Pro |
 | --- | --- |
-| *AI models* (Claude, Gemini, ChatGPT) | Unlimited usage |
+| *Cloud-hosted AI models* (Claude, Gemini, ChatGPT) | Current families and modes |
 | *Long-Term Memory* | Capture and search memories |
 | *MCP Server* | ✓ |
 

public/content/paid-plans.md

@@ -13,138 +13,31 @@ ogImage: "https://storage.googleapis.com/hashnode_product_documentation_assets/o
 
 ## About Pieces Pro
 
-Pieces Pro elevates your development workflow by providing access to premium AI models, early-release tools, and enhanced support.
-
-Designed for teams and individuals who demand cutting-edge capabilities, Pieces Pro builds on the free core features of snippet management and AI assistance.
+Pieces Pro provides access to Pieces' current cloud-hosted AI models, Long-Term Memory, and paid product features for individuals and teams.
 
 ## Pricing
 
-Choose the plan that works best for you:
-
-<CardGroup cols={3}>
-  <Card title="Free Plan" image="/assets/icons/pieces_logo.png">
-    <div className="mb-4">
-      <span className="inline-block px-3.5 py-1.5 rounded-full text-xs font-semibold tracking-wide bg-slate-200 dark:bg-slate-600 text-slate-700 dark:text-slate-300">Free Forever</span>
-    </div>
-
-    <div className="mb-6">
-      <div className="text-4xl font-bold leading-none text-slate-900 dark:text-white mb-1">Free</div>
-      <div className="text-sm text-slate-500 dark:text-slate-400">Perfect for getting started</div>
-    </div>
-
-    <div className="border-t border-slate-200 dark:border-slate-600 pt-4">
-      <div className="text-sm font-semibold text-slate-700 dark:text-slate-300 mb-3">Includes:</div>
-      <ul className="list-none p-0 m-0 text-sm text-slate-500 dark:text-slate-400 leading-relaxed">
-        <li className="mb-2">✓ Basic AI features</li>
-        <li className="mb-2">✓ Local storage only</li>
-        <li className="mb-2">✓ Community support</li>
-        <li>✓ Limited cloud backup</li>
-      </ul>
-    </div>
-  </Card>
-
-  <Card title="Pieces Pro Monthly" image="/assets/icons/pieces_logo.png">
-    <div className="mb-4">
-      <span className="inline-block px-3.5 py-1.5 rounded-full text-xs font-semibold tracking-wide bg-blue-100 dark:bg-blue-900/40 text-blue-800 dark:text-blue-200">Monthly Billing</span>
-    </div>
-
-    <div className="mb-6">
-      <div className="text-4xl font-bold leading-none text-slate-900 dark:text-white mb-1">$18.99</div>
-      <div className="text-sm text-slate-500 dark:text-slate-400">per month</div>
-    </div>
-
-    <div className="border-t border-slate-200 dark:border-slate-600 pt-4">
-      <div className="text-sm font-semibold text-slate-700 dark:text-slate-300 mb-3">Includes:</div>
-      <ul className="list-none p-0 m-0 text-sm text-slate-500 dark:text-slate-400 leading-relaxed">
-        <li className="mb-2">✓ Full access to Pieces Pro features</li>
-        <li className="mb-2">✓ AI-powered code generation</li>
-        <li className="mb-2">✓ Advanced code search</li>
-        <li>✓ Priority support</li>
-      </ul>
-    </div>
-  </Card>
-
-  <Card title="Pieces Pro Yearly" image="/assets/icons/pieces_logo.png">
-    <div className="mb-4">
-      <span className="inline-block px-3.5 py-1.5 rounded-full text-xs font-semibold tracking-wide bg-gradient-to-br from-blue-500 to-blue-600 text-white shadow-md shadow-blue-500/30">Most Popular</span>
-    </div>
-
-    <div className="mb-6">
-      <div className="text-4xl font-bold leading-none text-slate-900 dark:text-white mb-1">$169.99</div>
-      <div className="text-sm text-slate-500 dark:text-slate-400">per year <span className="text-emerald-600 dark:text-emerald-400 font-semibold">($14.17/month)</span></div>
-      <div className="text-xs text-emerald-600 dark:text-emerald-400 font-semibold mt-1">Save 20% compared to monthly</div>
-    </div>
-
-    <div className="border-t border-slate-200 dark:border-slate-600 pt-4">
-      <div className="text-sm font-semibold text-slate-700 dark:text-slate-300 mb-3">Includes:</div>
-      <ul className="list-none p-0 m-0 text-sm text-slate-500 dark:text-slate-400 leading-relaxed">
-        <li className="mb-2">✓ Full access to Pieces Pro features</li>
-        <li className="mb-2">✓ AI-powered code generation</li>
-        <li className="mb-2">✓ Advanced code search</li>
-        <li>✓ Priority support</li>
-      </ul>
-    </div>
-  </Card>
-</CardGroup>
-
-## Plan Comparison
-
-Compare Free and Pieces Pro to see which plan fits your workflow.
-
-### Free Plan — Model Access
-
-Every model family and mode is available on both Free and Pro. The free plan includes limited usage of AI models, while Pieces Pro unlocks unlimited usage—upgrade when you want to remove the caps.
-
-| **Feature** | **Free** | **Pieces Pro** |
-|-------------|----------|----------------|
-| AI models (all families) | Limited usage | Unlimited access |
-| Long-term memory | Rolling window (time-bound) | Unlimited (up to 9 months) |
-| AI-powered code generation | Basic | Advanced |
-| Support | Community | Priority |
-| Cloud backup | Limited | Full |
-
-For how to choose a model, see [Choose a Model](/products/desktop/conversational-search/models).
-
-## Frequently Asked Questions
-
-<AccordionGroup>
-  <Accordion title="Does the paid plan affect memory quality or just the built-in chat?">
-    Both. Pro gives you longer memory retention *and* access to more powerful models for searching and reasoning over your stored context. The Long-Term Memory engine that captures and organizes your workflow data is the same on both plans—the main differences are *duration* and *retrieval quality*.
-  </Accordion>
-
-  <Accordion title="How long does Long-Term Memory last on each plan?">
-    The free plan is time-bound: you have access to a rolling window of recent history. Pieces Pro offers unlimited long-term memory with up to 9 months of context.
-  </Accordion>
-
-  <Accordion title="What are the limits on premium model usage?">
-    The free plan includes limited usage of AI models to get started. Pro offers unlimited usage across all model families and modes. [See Choose a Model](/products/desktop/conversational-search/models) for how to pick a family and mode.
-  </Accordion>
-
-  <Accordion title="Does upgrading to Pro create better memories?">
-    No. The engine that captures and organizes your data is the same. Pro users get *longer* retention (up to 9 months vs a rolling window) and can use more powerful models to *search and query* those memories, yielding deeper insights—but the underlying memory formation is identical.
-  </Accordion>
-</AccordionGroup>
+Pieces is currently offered through paid plans for individuals and organizations. Monthly and annual options may be available. Checkout is the source of truth for the plan, billing interval, price, taxes, discounts, and any trial shown for your account before you confirm a purchase.
+
+<Callout type="info">
+  Prices, intervals, and any trial can vary by account. Review the order summary in the official Pieces checkout before paying.
+</Callout>
 
 ## Benefits
 
-Unlimited access to *premium LLMs, infinite long-term memory,* and *priority support* are a combination that empowers your team to code smarter, faster, and with greater confidence.
+Pieces Pro combines cloud-hosted AI models with Long-Term Memory and paid product features. Available models and product limits can change as Pieces evolves.
 
 <Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/paid-plans/update-to-pieces-pro.png" alt="Upgrade to Pieces Pro prompt in the Desktop App" align="center" fullwidth="true" />
 
 ### Premium AI Models
 
-Pieces offers four model families, each available in Fast, Balanced, and Extra Thinking modes:
+Pieces offers three model families, each available in Fast, Balanced, and Extra Thinking modes:
 
 * **Claude**
 * **Gemini**
-* **Grok**
 * **ChatGPT**
 
-Real-time web search is powered by Perplexity. Every family and mode is available on both Free and Pro—Pro removes the usage caps.
-
-<Callout type="tip">
-  To pick a family and mode, see [Choose a Model](/products/desktop/conversational-search/models).
-</Callout>
+Real-time web search is powered by Perplexity. For the current model list and available modes, see [Choose a Model](/products/desktop/conversational-search/models).
 
 ## Upgrading to Pieces Pro
 
@@ -296,7 +189,7 @@ Click `Cancel subscription` in the *Subscription* tab. You’ll be redirected to
   </Step>
 
   <Step title="Choose an Option">
-    Click `Cancel subscription` to end your plan immediately or click `Back` to return without canceling.
+    Click `Cancel subscription` to schedule cancellation at the end of the current billing period, or click `Back` to return without canceling. Your access continues until the effective cancellation date shown in the billing dashboard.
 
     <Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/paid_plan/cancel_subscription_active.png" alt="Cancel subscription confirmation dialog" align="center" fullwidth="true" />
   </Step>

public/content/paid-plans/manage-subscription.md

@@ -40,5 +40,5 @@ Apply a discount code to your active Pieces Pro subscription. The discount takes
 From the Billing tab you can also:
 
 * **Change Plan** — Switch between monthly and yearly billing, or upgrade/downgrade your plan
-* **Manage Billing** — Update payment methods and view billing details via Stripe
-* **Cancel Subscription** — End your Pieces Pro subscription
+* **Manage Billing** — Update payment methods and view billing details in the Paddle customer portal
+* **Cancel Subscription** — Schedule your Pieces Pro subscription to end after the current billing period