From e22626ccf89e4ef68790575d87ae19de41f86859 Mon Sep 17 00:00:00 2001 From: pieces-docs-mirror-app Date: Fri, 4 Sep 2026 16:32:28 +0000 Subject: [PATCH] chore(mirror): sync docs from pieces-documentation (run 33895477313) --- public/content/cli/configuration.md | 2 +- public/content/core-dependencies/pieces-os.md | 2 +- .../content/desktop/configuration/models.md | 2 +- .../content/desktop/conversational-search.md | 2 +- .../desktop/conversational-search/models.md | 5 +- .../using-conversational-search.md | 2 +- public/content/meet-pieces/fundamentals.md | 2 +- .../linux-installation-guide/flatpak.md | 62 +++++---- .../meet-pieces/managing-your-account.md | 2 +- public/content/paid-plans.md | 127 ++---------------- .../content/paid-plans/manage-subscription.md | 4 +- public/content/privacy-security-your-data.md | 4 +- 12 files changed, 56 insertions(+), 160 deletions(-) diff --git a/public/content/cli/configuration.md b/public/content/cli/configuration.md index ed2d393..aa9ea5c 100644 --- a/public/content/cli/configuration.md +++ b/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). diff --git a/public/content/core-dependencies/pieces-os.md b/public/content/core-dependencies/pieces-os.md index 7286f68..08ad36a 100644 --- a/public/content/core-dependencies/pieces-os.md +++ b/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 diff --git a/public/content/desktop/configuration/models.md b/public/content/desktop/configuration/models.md index 029ae04..6b8d0d1 100644 --- a/public/content/desktop/configuration/models.md +++ b/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. diff --git a/public/content/desktop/conversational-search.md b/public/content/desktop/conversational-search.md index ee8a74e..f292fd5 100644 --- a/public/content/desktop/conversational-search.md +++ b/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 - 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. diff --git a/public/content/desktop/conversational-search/models.md b/public/content/desktop/conversational-search/models.md index 992efc1..296fa41 100644 --- a/public/content/desktop/conversational-search/models.md +++ b/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*. - Hover over **Claude**, **Gemini**, **Grok**, or **ChatGPT**. + Hover over **Claude**, **Gemini**, or **ChatGPT**. Click **Fast**, **Balanced**, or **Extra Thinking** for that family. diff --git a/public/content/desktop/conversational-search/using-conversational-search.md b/public/content/desktop/conversational-search/using-conversational-search.md index b502594..767c00c 100644 --- a/public/content/desktop/conversational-search/using-conversational-search.md +++ b/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 - 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. diff --git a/public/content/meet-pieces/fundamentals.md b/public/content/meet-pieces/fundamentals.md index 331f78b..7479162 100644 --- a/public/content/meet-pieces/fundamentals.md +++ b/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 diff --git a/public/content/meet-pieces/linux-installation-guide/flatpak.md b/public/content/meet-pieces/linux-installation-guide/flatpak.md index dc1f019..a27216c 100644 --- a/public/content/meet-pieces/linux-installation-guide/flatpak.md +++ b/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. - - - 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. - +[Install Pieces Desktop App (`.flatpakref`)](https://builds.pieces.app/pieces-flatpak-repo/com.pieces.pfd.flatpakref) - - 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. - +Prefer the command line? Run these commands in order. + - 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. - 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. - - **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. + + 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 ``` + - Once PiecesOS is running, 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. @@ -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: diff --git a/public/content/meet-pieces/managing-your-account.md b/public/content/meet-pieces/managing-your-account.md index 776ac94..7b452b9 100644 --- a/public/content/meet-pieces/managing-your-account.md +++ b/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* | ✓ | diff --git a/public/content/paid-plans.md b/public/content/paid-plans.md index d259631..05d3c86 100644 --- a/public/content/paid-plans.md +++ b/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: - - - -
- Free Forever -
- -
-
Free
-
Perfect for getting started
-
- -
-
Includes:
-
    -
  • ✓ Basic AI features
    • -
  • ✓ Local storage only
    • -
  • ✓ Community support
    • -
  • ✓ Limited cloud backup
    • -
-
- - - -
- Monthly Billing -
- -
-
$18.99
-
per month
-
- -
-
Includes:
-
    -
  • ✓ Full access to Pieces Pro features
    • -
  • ✓ AI-powered code generation
    • -
  • ✓ Advanced code search
    • -
  • ✓ Priority support
    • -
-
- - - -
- Most Popular -
- -
-
$169.99
-
per year ($14.17/month)
-
Save 20% compared to monthly
-
- -
-
Includes:
-
    -
  • ✓ Full access to Pieces Pro features
    • -
  • ✓ AI-powered code generation
    • -
  • ✓ Advanced code search
    • -
  • ✓ Priority support
    • -
-
- - - -## 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 - - - - 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*. - - - - 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. - - - - 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. - - - - 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. - - +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. + + + Prices, intervals, and any trial can vary by account. Review the order summary in the official Pieces checkout before paying. + ## 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. Upgrade to Pieces Pro prompt in the Desktop App ### 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. - - - To pick a family and mode, see [Choose a Model](/products/desktop/conversational-search/models). - +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 - 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. Cancel subscription confirmation dialog diff --git a/public/content/paid-plans/manage-subscription.md b/public/content/paid-plans/manage-subscription.md index 10e1460..5dc19b6 100644 --- a/public/content/paid-plans/manage-subscription.md +++ b/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 diff --git a/public/content/privacy-security-your-data.md b/public/content/privacy-security-your-data.md index c85768f..786f771 100644 --- a/public/content/privacy-security-your-data.md +++ b/public/content/privacy-security-your-data.md @@ -17,7 +17,7 @@ ogImage: "https://storage.googleapis.com/hashnode_product_documentation_assets/o ## Local-First by Design **Your data stays on your machine.** Pieces captures and stores your code, chats, and long-term memory context locally on your device—there is no continuous sync and no bulk upload to our cloud. -AI features that need a large language model (like chat) run in the cloud by default, since Pieces no longer ships local models. When you use one, only a scoped, per-request slice of context is sent to the model—the rest of your data never leaves your machine. Telemetry is clearly marked, and you keep granular control over everything you share. +AI features that need a large language model (like chat) run in the cloud by default. When you use one, only a scoped, per-request slice of context is sent to the model—the rest of your data never leaves your machine. Telemetry is clearly marked, and you keep granular control over everything you share. Pieces is **SOC 2 Type II certified** and enterprise-ready. We never use your data to train models, and you can delete everything at any time by removing the `com.pieces.os` folder. @@ -75,7 +75,7 @@ Capture, indexing, and storage run on-device, your data is isolated per user, an * **Decentralized by default** — no centralized server holds your data, so there's no single point of failure. ### What Runs On-Device vs. Cloud -Pieces captures and stores your data on-device. AI features that need a large language model run in the cloud, since Pieces no longer ships local models. +Pieces captures and stores your data on-device. AI features that need a large language model run in the cloud. | **Capability** | **On-Device** | **Cloud** | | --- | :---: | :---: |