PiecesOS | Quick Menu

Read documentation and see visuals demonstrations of the PiecesOS Quick Menu for macOS, Windows, and Linux.

macOS & Windows

The Quick Menu is a lightweight interface for interacting with PiecesOS, located in your menu bar (macOS & Linux) or system tray (Windows).

This popover lets manage your PiecesOS settings, Long-Term Memory Engine (LTM-1) configurations, and application integrations.

It enables you to monitor PiecesOS status, toggle memory and AI processing settings, and access critical resources without launching a separate application, and more.

For Linux users, available options are currently more limited.

Quick Menu Actions

There are a several different views that you can enter in the Quick Menu on macOS and Windows:

  • Account: You can log in or log out of your Pieces Account.

  • Version: Check for and automatically install available PiecesOS updates.

  • Long-Term Memory Engine: Enable or disable the Long-Term Memory Engine.

  • Long-Term Memory Access Control: Enable or disable sources from which the Long-Term Memory Engine captures contextual workflow data.

  • Settings: Adjust settings like launch on login, enabled Pieces products, ML processing configurations, telemetry permissions, or optimize RAM usage.

  • Activity: View recent LTM-1 activity, like most recent Copilot Chats, people, and related websites.

  • Resources: Find links to documentation and Pieces for Developers social accounts.

PiecesOS Quick Menu on macOS

The PiecesOS Quick Menu shares the same user interface (UI) as the Quick Menu on Windows.

Media for this Quick Menu documentation has been captured exclusively on macOS.

1

Logging In & Logging Out

At the top of the Quick Menu, you can log in or log out of your Pieces account. Logging in allows access to cloud-connected features, such as:

  • Syncing preferences across devices

  • Cloud model processing (if enabled)

  • Accessing saved snippets across devices

If you log out, PiecesOS will continue running locally with saved configurations but will not sync to the cloud.

You can also create backups of your Pieces Drive to upload your local repository to the cloud under the Manage Backups section.

2

Checking for Updates

Directly under your account information, the Quick Menu displays your current PiecesOS version and whether it is up to date.

  • If a new update is available, you will see an Update Available button. Clicking it will initiate the update process.

  • If PiecesOS is up to date, the menu will display a green check-mark and show the active version—i.e., 11.0.4.

3

Long-Term Memory (LTM-1)

LTM-1 is PiecesOS’s core memory engine, capturing workflow context locally to enhance productivity. You can toggle it on or off from the Quick Menu.

4

Long-Term Memory Access Control

This section allows you to manage which applications and sources LTM-1 captures data from.

1. Enabled Sources

This view displays a list of apps that LTM-1 is actively gathering data from (e.g., Google Chrome, ChatGPT).

Clicking on an enabled source opens a window where you can disable it.

2. Disabled Sources

Apps or sources that LTM-1 is blocked from accessing appear here.

Click the Add button to open a Finder (macOS) or Folder (Windows) window, where you can manually select additional applications to allow memory capture.

Settings

The Settings menu allows you to configure PiecesOS to best suit your workflow.

1

Optimize Memory Usage

Adjusts memory allocation for PiecesOS to reduce resource consumption while maintaining performance.

2

Launch on Login

Enable or disable automatic startup for PiecesOS when your computer boots up.

3

Enabled Apps

View a list of applications that have Pieces plugins and extensions installed.

4

Telemetry Sharing

Enable or disable telemetry data collection on an individual application, plugin, or extension basis.

When enabled, PiecesOS sends anonymous crash reports and usage statistics to help the development team improve Pieces.

5

ML Processing

This menu controls how PiecesOS manages AI model inference. You can use Blended Mode or Local Mode to switch between using a combination of local and cloud-based LLMs for performance, or purely on-device processing with no cloud dependencies.

You can also make changes to the enrichment to level and type to individual applications for more fine-tuned control.

Activity

The Activity menu provides a log of recent actions and interactions within PiecesOS, such as:

  1. Most Recent Copilot Chat: Displays the last Copilot conversation timestamp.

  2. Most Recent People: Lists recognized people based on saved materials and shared code.

  3. Most Recent Websites: Shows the last visited web pages that were captured by PiecesOS. Each website is listed with a clickable URL

Resources

The Resources provides quick access to documentation, support, and community links:

Linux

The Pieces Quick Menu on Linux contains several helpful resources and links, such as:

  • Discoverer Integrations: Opens the Pieces website where all Pieces for Developers browser and IDE extensions and plugins can be found.

  • About: Launches the About page for Pieces for Developers.

  • Documentation: Brings you to the official Pieces for Developers documentation, where you can browse through guides and troubleshooting information for the entire Pieces Suite.

  • Submit Feedback or Issues: If you are experiencing an issue, click this button to open a webpage containing a type form for submitting bug reports or providing feedback—or visit our Support page here to do so.

  • Optimize Memory Usage: Adjusts memory allocation for PiecesOS to reduce resource consumption while maintaining performance.

  • Quit: Quits PiecesOS. To relaunch, open your terminal and type pieces-os and press enter or find the PiecesOS launcher from your application tray.

As a background resource task, there are currently less adjustable actions, but the LTM-1, Pieces Drive and Pieces Copilot can still be accessed and utilized within Pieces plugins and extensions on Linux.

Updated on
Manual Installation
Troubleshooting