Accessing Settings
There are two ways to open up the Settings view in the Pieces Desktop App.
You can either navigate to the Power Menu by clicking the Home Icon
, or if in the Pieces Copilot view, click the small Settings
gear in the bottom-left hand corner of the application.
This will open up the settings & configuration menu where you can adjust account and cloud behaviors, check your application versions, adjust views and layouts, and more.
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.
Aesthetics & Layouts
The Aesthetics & Layouts section allows you to customize the visual appearance of the Pieces Desktop App—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 a range of 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 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 as well as the frequency of notification pop-up modals.
Shortcuts
View the list of default shortcuts for Pieces Desktop App functionality specific to your devices 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—there are always three smaller Support & Information sections 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: Lists the Pieces Desktop App version, lets you check for updates, launch onboarding, and provides your platform information.
-
PiecesOS Information: Lists your PiecesOS version, lets you check for updates, and lists the active PiecesOS port.