Accessing Settings
There are several ways to open up Settings in the Pieces Desktop App, where you can adjust account and cloud behaviors, check your application versions, change views and layouts, and more.
You can access Settings by clicking the profile picture icon in the upper-right and clicking All Settings.
Or, click the Settings Gear icon in the bottom-left corner to open the Settings view.
You can also open up the Power Menu and search for “settings”, then click Go to Settings using the shortcuts in the table below:
macOS | Windows | Linux |
|---|---|---|
|
|
|
Account & Cloud
The Account & Cloud section manages your Pieces account, cloud services, and backups. This ensures a seamless connection across devices and helps keep your data secure.
Cloud Management
Connect and sync with Pieces Cloud for real-time access across multiple devices, or monitor your connection status and manage sync preferences.
Database Backups
Automatically backup your snippets, files, and projects or restore previous versions in case of data loss.
Pieces Copilot & Machine Learning
These Pieces Copilot and Pieces Drive configuration sections let you adjust default behaviors related to metadata, LTM context, models, and local model processing.
Runtime
Change models, reset the active runtime if facing issues, and use Long-Term Memory (LTM) context by default, and more.
Enrichment
Adjust the level of auto-enrichment performed locally when Pieces Drive generates and assigns metadata to saved materials.
Model Content Protocol (MCP)
From this view, you can access the HTTP Server URL for the Pieces MCP. This allows you to set up productivity tools and code editors that support this protocol with context directly from your local Pieces database.
You'll also find a Book icon that links you to documentation on getting started with the Pieces MCP and information about available integrations.
Aesthetics & Layouts
The Aesthetics & Layouts section allows you to customize the visual appearance of the Pieces Desktop App, including dark and light modes, UI scaling, accent color, and more.
You can also set the default UI of different views and adjust default sorting and listing methods for displaying snippets & summaries
Dark & Light Mode
Adjust auto-switch settings based on system preferences.
Accent Colors
Select from various colors to adjust Pieces Copilot chat accents and other visual elements.
Font & UI Scaling
Increase or decrease font size and UI size for different screen resolutions.
Layout Settings
Set the default view to Pieces Copilot or Pieces Drive, default search mode, and default gallery & list views.
Default Search Mode
Choose between Blended, Full-Text, Neural Code Search, or Search-with-Material as the default search mode for the Search Bar.
Additional Settings
The Additional Settings section contains advanced configurations that allow you to fine-tune Pieces for Developers to suit your workflow.
Telemetry & Diagnostics
Enable or disable anonymous usage data collection and manage crash reporting and performance monitoring.
Notifications
Customize which in-app alerts you receive and the frequency of notification pop-up modals.
Shortcuts
View the default shortcuts for Pieces Desktop App functionality specific to your device’s operating system (OS).
Support & Information
Whenever you access the Settings view and click on a specific section—i.e., Machine Learning, Telemetry, or Copilot Chats—three smaller Support & Information sections are appended to the end of the focused settings view.
These always-available sections are:
-
Support: Contains links to documentation, submitting feedback or reporting issues, and all keyboard shortcuts.
-
Desktop App Information: This section lists the Pieces Desktop App version, lets you check for updates, launches onboarding, and provides your platform information.
-
PiecesOS Information: This page lists your PiecesOS version, lets you check for updates, and lists the active PiecesOS port.
