Skip to content

chore(mirror): sync docs from pieces-documentation (29775995484) #111

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
piecesdocumentationbot merged 1 commit into from
Jul 20, 2026
Merged

chore(mirror): sync docs from pieces-documentation (29775995484) #111

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions public/content/desktop/actions/power-menu.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -109,8 +109,7 @@ Manage your account, cloud integrations, backups, and updates with these command
| *Toggle Light Mode* | Switch the user interface between light and dark themes. |
| *Manage Accounts & Cloud Integrations* | Connect or configure your Pieces Cloud and linked accounts. |
| *Manage Early Access Program* | Enroll in or manage beta features of Pieces. |
| *Check for Desktop App Updates* | Manually verify if a new version of the Pieces desktop app is available. |
| *Check for Pieces OS Updates* | Inspect whether Pieces OS has an update ready. |
| *Check for Updates* | Check for and install updates to both the Desktop App and PiecesOS. |
| *Manage In-App Notifications* | Configure or silence various in-app alerts and messages. |
| *Manage Pieces Drive Action Toolbar* | Customize toolbar actions for Pieces Drive integrations. |
| *Turn Long-Term Memory Engine Off* | Disable the memory engine that stores historical snippet context. |
Expand Down
4 changes: 2 additions & 2 deletions public/content/desktop/configuration/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -176,7 +176,7 @@ Manually check if a new version of PiecesOS is available. Updates may include bu
</Step>

<Step title="Click Check for Updates">
Click the `Check for PiecesOS Updates` link (server rack with refresh arrow icon) to manually trigger an update check. If an update is available, you'll be prompted to install it.
Click the `Check for Updates` link to manually trigger an update check. If an update is available, you'll be prompted to install it. Both PiecesOS and the Desktop App update together.
</Step>
</Steps>

Expand Down Expand Up @@ -240,7 +240,7 @@ Manually check if a new version of the Pieces Desktop App is available. Updates
</Step>

<Step title="Click Check for Updates">
Click the `Check for Desktop App Updates` link to manually trigger an update check. If an update is available, you'll be prompted to install it.
Click the `Check for Updates` link to manually trigger an update check. If an update is available, you'll be prompted to install it. Both PiecesOS and the Desktop App update together.
</Step>
</Steps>

Expand Down
39 changes: 18 additions & 21 deletions public/content/desktop/troubleshooting/macos.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,36 +55,33 @@ Our `.pkg` files install both PiecesOS and the Pieces Desktop App in a single gu

## Versions & Updates

Many issues can stem from out-of-date MCP integrations, PiecesOS, or the desktop app itself.
Many issues can stem from out-of-date MCP integrations, PiecesOS, or the desktop app itself. When you check for updates from either the Desktop App or the PiecesOS Quick Menu, both apps update together.

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/desktop/configuration/troubleshooting/update_PFD_POS_dropdown.png" alt="Profile menu with Check for Updates for Desktop App and PiecesOS" align="center" fullwidth="true" />

### Updating the Pieces Desktop App

Update the Pieces Desktop App on macOS by clicking your `User Profile` in the top left, then hovering over `Update` and selecting `Desktop App` or `PiecesOS`.

To check the Pieces Desktop App for updates on macOS:
### From the Desktop App

<Steps>
<Step title="Open the Pieces Desktop App">
Use the **Search** option or locate the Pieces Desktop App within your *Applications* folder
<Step title="Open the profile menu">
Click your profile or username in the top-left corner of the Pieces Desktop App.
</Step>

<Step title="Click Your User Profile">
Click your `User Profile` in the top left of the main app view
<Step title="Check for Updates">
Click `Check for Updates` in the dropdown menu.
</Step>

<Step title="Hover Over Update">
Hover over `Update` in the dropdown menu that appears
</Step>

<Step title="Select Component to Update">
Click on either `Desktop App` or `PiecesOS` from the Update submenu to check for and install updates for that component
<Step title="Install if prompted">
If an update is available, follow the on-screen prompt to install it, then restart when complete.
</Step>
</Steps>

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/desktop_app_assets/updating_pieces_via_desktop.png" alt="" align="center" fullwidth="true" />

> Profile menu in the Pieces Desktop App with `Check for Updates`

### From the PiecesOS Quick Menu

Click the Pieces icon in your menu bar and click `You're up to date` to trigger a check. If an update is available, follow the prompt to install.

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/core-dependencies/quick-menu_check_for_updates.png" alt="" align="center" fullwidth="true" />

You can also click `Check for PiecesOS Updates` as an alternative to doing so in from the PiecesOS system window in your taskbar.
> PiecesOS Quick Menu showing your current version and update status

## Common Installation Issues

Expand Down
34 changes: 13 additions & 21 deletions public/content/desktop/troubleshooting/windows.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,37 +47,29 @@ If you’re experiencing difficulties installing the Pieces Desktop App, you can

## Versions & Updates

Many issues can stem from out-of-date MCP integrations or the Desktop App itself.
Many issues can stem from out-of-date MCP integrations or the Desktop App itself. When you check for updates from either the Desktop App or the PiecesOS Quick Menu, both apps update together.

### Updating the Pieces Desktop App

Updating the Pieces Desktop App on Windows (and macOS) can be done directly within the application:
### From the Desktop App

<Steps>
<Step title="Open the Pieces Desktop App">
Press the `Windows Icon` and search for Pieces Desktop, open it
<Step title="Open the profile menu">
Click your profile or username in the top-left corner of the Pieces Desktop App.
</Step>

<Step title="Click Your User Profile">
Click your `User Profile` in the top left of the main app view
<Step title="Check for Updates">
Click `Check for Updates` in the dropdown menu.
</Step>

<Step title="Hover Over Update">
Hover over `Update` in the dropdown menu that appears
<Step title="Install if prompted">
If an update is available, follow the on-screen prompt to install it, then restart when complete.
</Step>
</Steps>

<Step title="Select Component to Update">
Click on either `Desktop App` or `PiecesOS` from the Update submenu to check for and install updates for that component
</Step>
<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/desktop_app_assets/windows_updating_pieces_via_desktop.png" alt="" align="center" fullwidth="true" />

<Step title="Update Pieces">
If prompted, click `Download Update` to install available updates.
</Step>
</Steps>
> Profile menu in the Pieces Desktop App with `Check for Updates`

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/desktop_app_assets/desktop_app_MAIN/new_media/Troubleshooting/Windows/updating_pieces_desktop.png" alt="Checking for Pieces Desktop App updates on Windows" align="center" fullwidth="true" />
### From the PiecesOS Quick Menu

You can also select `Check for PiecesOS Updates` from the same menu as an alternative to doing so from the PiecesOS system window in your taskbar.
Click the Pieces icon in your system tray and click `You're up to date` to trigger a check. If an update is available, follow the prompt to install.

## Common Installation Issues

Expand Down
22 changes: 22 additions & 0 deletions public/content/meet-pieces/linux-installation-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,28 @@ Pieces for Linux is available via **Snap** (recommended for Ubuntu) or **Flatpak
Check your session with `echo $XDG_SESSION_TYPE` (`wayland` or `x11`). On **Wayland**, use `pieces-os.doctor` to wire up interfaces; labels in **Settings → System** vary by distro.
</Callout>

## Updating

On Linux, update PiecesOS and the Desktop App using your package manager. Both packages update together.

### Snap

```bash
sudo snap refresh pieces-os pieces-for-developers
```

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/meet_pieces_assets/meet_pieces/troubleshooting/linux/snap_refresh_POS.gif" alt="" align="center" fullwidth="true" />

> Running `snap refresh` to update Pieces on Linux

### Flatpak

```bash
flatpak update -y com.pieces.os com.pieces.pfd
```

You can also check for updates from the Desktop App by clicking your profile in the top-left corner and selecting `Check for Updates`.

## Additional Resources

See the [Linux troubleshooting guide](/products/meet-pieces/troubleshooting/linux) or reach out to [support](/products/support) for help.
2 changes: 1 addition & 1 deletion public/content/meet-pieces/linux-installation-guide/flatpak.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@ To manually update both PiecesOS and the Pieces Desktop App, run:
flatpak update -y com.pieces.os com.pieces.pfd
```

You can also check for updates within the Pieces Desktop App by hovering over your username in the top left, then hovering over `Update` and selecting `Check for Desktop App Updates` or `Check for PiecesOS Updates`.
You can also check for updates from the Desktop App by clicking your profile in the top-left corner and selecting `Check for Updates`. Both apps update together.

<Callout type="tip">
Some desktop environments (like GNOME Software or KDE Discover) can manage Flatpak updates through their graphical interface. Look for Pieces in your software center to update from there.
Expand Down
12 changes: 9 additions & 3 deletions public/content/meet-pieces/linux-installation-guide/snap.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,11 +44,17 @@ After installing via Snap, run `pieces-os.doctor` in your terminal. The script o

### Updating

The Pieces Desktop App automatically downloads and installs new updates.
Update both packages with Snap:

You can also manually check for updates by hovering over your username in the top left, then hovering over `Update` and selecting either `Check for Desktop App Updates` or `Check for PiecesOS Updates`.
```bash
sudo snap refresh pieces-os pieces-for-developers
```

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/meet_pieces_assets/meet_pieces/get_started_linux/checking_pieces_desktop_app_for_pieces_os_updates.gif" alt="Checking for PiecesOS updates in the Pieces Desktop App on Linux" align="center" fullwidth="true" />
You can also check for updates from the Desktop App by clicking your profile in the top-left corner and selecting `Check for Updates`. Both apps update together.

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/meet_pieces_assets/meet_pieces/troubleshooting/linux/snap_refresh_POS.gif" alt="" align="center" fullwidth="true" />

> Running `snap refresh` to update Pieces on Linux

### Uninstalling

Expand Down
39 changes: 36 additions & 3 deletions public/content/meet-pieces/macos-installation-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,11 +41,44 @@ Pieces for macOS is available via **DMG** (recommended), **PKG**, or **Homebrew*

## Updating

The Pieces Desktop App automatically downloads and installs new updates.
Pieces automatically downloads and installs updates. When you check for updates from either the Desktop App or the PiecesOS Quick Menu, both apps update together.

You can also manually check for updates by hovering over your username in the top left, then hovering over `Update` and selecting either `Check for Desktop App Updates` or `Check for PiecesOS Updates`.
### From the Desktop App

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/meet_pieces_assets/meet_pieces/get_started/macos/macos_check_pfd_for_updates_profile_dropdown.gif" alt="Checking for updates via the profile dropdown on macOS" align="center" fullwidth="true" />
<Steps>
<Step title="Open the profile menu">
Click your profile or username in the top-left corner of the Pieces Desktop App.
</Step>
<Step title="Check for Updates">
Click `Check for Updates` in the dropdown menu.
</Step>
<Step title="Install if prompted">
If an update is available, follow the on-screen prompt to install it, then restart when complete.
</Step>
</Steps>

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/desktop_app_assets/updating_pieces_via_desktop.png" alt="" align="center" fullwidth="true" />

> Profile menu in the Pieces Desktop App with `Check for Updates`

### From the PiecesOS Quick Menu

<Steps>
<Step title="Open the Quick Menu">
Click the Pieces icon in your menu bar.
</Step>
<Step title="Check for updates">
Click `You're up to date` to trigger a check. If an update is available, follow the prompt to install.
</Step>
</Steps>

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/core-dependencies/quick-menu_check_for_updates.png" alt="" align="center" fullwidth="true" />

> PiecesOS Quick Menu showing your current version and update status

<Callout type="tip">
Pieces often downloads updates automatically and notifies you when a new version is ready. Use either method above to check manually.
</Callout>

## Uninstalling

Expand Down
40 changes: 9 additions & 31 deletions public/content/meet-pieces/sign-into-pieces.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -101,50 +101,28 @@ To use the new sign-in features, you must update both PiecesOS and the Pieces De
You must update to version 15.0.0 or later to use the Pieces Suite. Both PiecesOS and the Desktop App must be updated for sign-in to work properly.
</Callout>

### Update PiecesOS
### Update Pieces

PiecesOS runs in the background and powers all Pieces features.
When you check for updates, both PiecesOS and the Desktop App update together.

<Steps>
<Step title="Find PiecesOS">
Check your menu bar (Mac) or system tray (Windows/Linux) for the PiecesOS icon.
</Step>

<Step title="Open Update Options">
Right-click the icon and select `You're up to date`—this will trigger an automatic check for updates.
</Step>

<Step title="Install Update">
If an update is available, click `Update Now`.
</Step>

<Step title="Wait for Restart">
PiecesOS will restart automatically when complete.
</Step>
</Steps>

### Update Pieces Desktop App

After updating PiecesOS, update the desktop app:

<Steps>
<Step title="Open Pieces">
Launch the Pieces Desktop App.
<Step title="Open the profile menu">
Launch the Pieces Desktop App and click your profile in the top-left corner.
</Step>

<Step title="Check for Updates">
Click your profile icon (right side of the search bar) and select `Check for Desktop App Updates`.
Click `Check for Updates` in the dropdown menu.
</Step>

<Step title="Install Update">
Click `Update` when prompted to download and install the latest version.
If an update is available, follow the on-screen prompt to install it.
</Step>

<Step title="Restart App">
Restart the app when the update completes.
<Step title="Restart">
Restart when the update completes.

<Callout type="info">
You may also see an update notification automatically when you open either of the apps.
You can also check for updates from the PiecesOS Quick Menu by clicking `You're up to date` in your menu bar (Mac) or system tray (Windows).
</Callout>
</Step>
</Steps>
Expand Down
50 changes: 19 additions & 31 deletions public/content/meet-pieces/troubleshooting/macos.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,52 +52,40 @@ A singular brew command, `brew install—- cask pieces`, automatically manages i

## Versions & Updates

Many issues can stem from out-of-date MCP integrations, the desktop app, or PiecesOS.
Many issues can stem from out-of-date MCP integrations, the desktop app, or PiecesOS. When you check for updates from either the Desktop App or the PiecesOS Quick Menu, both apps update together.

### Updating PiecesOS
### From the Desktop App

<Steps>
<Step title="Ensure PiecesOS is Running">
Make sure PiecesOS is running—look for the **Pieces Icon** in your system tray (menu bar).
<Step title="Open the profile menu">
Click your profile or username in the top-left corner of the Pieces Desktop App.
</Step>
<Step title="Check for and Install Updates">
Check for available updates and install them if prompted.
<Step title="Check for Updates">
Click `Check for Updates` in the dropdown menu.
</Step>
<Step title="Install if prompted">
If an update is available, follow the on-screen prompt to install it, then restart when complete.
</Step>
</Steps>

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/core-dependencies/quick-menu_check_for_updates.png" alt="PiecesOS Quick Menu showing check for updates option" align="center" fullwidth="true" />
<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/desktop_app_assets/updating_pieces_via_desktop.png" alt="" align="center" fullwidth="true" />

### Updating the Pieces Desktop App
> Profile menu in the Pieces Desktop App with `Check for Updates`

Updating the Pieces Desktop App on macOS can be done directly from the app:
### From the PiecesOS Quick Menu

<Steps>
<Step title="Open the Pieces Desktop App">
Launch the Pieces Desktop App.
</Step>

<Step title="Click Your Username">
Click your username in the top left of the app.
</Step>

<Step title="Hover Over Update">
Hover over `Update` in the dropdown menu.
<Step title="Open the Quick Menu">
Click the Pieces icon in your menu bar.
</Step>

<Step title="Select Component to Update">
Click on either `Desktop App` or `PiecesOS` from the Update submenu to check for and install updates for that component.
</Step>

<Step title="Restart App">
Restart the app when the update completes.

<Callout type="info">
You may also see an update notification automatically when you open either of the apps.
</Callout>
<Step title="Check for updates">
Click `You're up to date` to trigger a check. If an update is available, follow the prompt to install.
</Step>
</Steps>

<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/desktop/configuration/troubleshooting/update_PFD_POS_dropdown.png" alt="Pieces Desktop App update dropdown menu on macOS" align="center" fullwidth="true" />
<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/core_desktop_meet-pieces_orgs_paid-plans_12.3.6/core-dependencies/quick-menu_check_for_updates.png" alt="" align="center" fullwidth="true" />

> PiecesOS Quick Menu showing your current version and update status

## Common Installation Issues

Expand Down
Loading
Loading