Settings

Customize, adjust, and configure PiecesOS and the Pieces Desktop App to suit your workflow and privacy preferences.


Overview

The Settings page in Pieces for Developers contains all of the configurable options, adjustable preferences, and modifiable behaviors for the Desktop Application.

By integrating external services or customizing the interface, you can tailor the Pieces Desktop App to your coding workflow.

Accessing Settings

To access settings, press ⌘+, (macOS) or ctrl+, (Windows/Linux).

You can also open the Power Menu, type ‘settings’ in the search field, then select Go To Settings from the dropdown.

Understanding the Settings Layout

When you open Settings, you’ll find several configuration categories on the left side and an All tab at the top.

Click any category to reveal its associated options in the main panel.

  • Categories: Organized for quick navigation.

  • All: Displays every setting in one place.

You can review each section individually or see everything at once by selecting All.

Account & Integrations

In this section, you can integrate external services with Pieces and adjust your user details, beginning with Account Information.

This area displays your email address and any linked accounts.

If you’re interested in testing upcoming features, the Early Access Program lets you join beta releases and stay ahead of the curve.

Personal Cloud

The Personal Cloud tab controls how your snippets and materials sync across devices.

You’ll see a status for your cloud connection (including the last sync time), plus options to set or modify your personal domain.

There’s also a Backup & Restore Data feature to preserve or retrieve your snippets from the cloud whenever needed.

  • Status: Check if your cloud is connected and see when it last synced.

  • Domain: Update your personal domain.

  • Backup & Restore Data: Protect your snippets and data.

Copilot Chats

Within Pieces Copilot Chats, decide which LLM runtime powers the Pieces Copilot and manage your chat-specific settings.

You can Manage Copilot LLM Runtime or Hard-Reset Active Runtime if it becomes unresponsive. You can also pick an accent color for the chat UI, and Delete All Copilot Chats to clear your chat history.

  • Manage Copilot LLM Runtime: Switch or reset your current LLM.

  • Hard-Reset Active Runtime: Restart the runtime if it’s unresponsive.

  • Delete All Copilot Chats: Remove your entire chat history.

Machine Learning

Pieces uses an on-device ML engine (with optional cloud capabilities) to enrich and tag your snippets.

You can toggle Auto-Generated Tags, Auto-Generated Websites, Auto-Generated Hints, and Auto-Generated People.

Adjust the Enrichment Level (0 to 9) or choose an Enrichment Mode (local, cloud, or blended). The LTM captures historical data for additional context—if needed, you can clear it to start fresh.

  • Auto-Generated Tags: Enable or disable automated tagging.

  • Auto-Generated Websites, Auto-Generated Hints, Auto-Generated People: Fine-tune which content gets generated.

  • Enrichment Level: Control how detailed the ML analysis should be.

  • Enrichment Mode: Decide between local, cloud, or blended.

  • Long-Term Memory Engine: Provides temporal context, with an option to clear data.

Views & Layouts

Views & Layouts controls how you see content in Pieces.

You can set a Default Layout, choose how items are sorted in list or gallery views, and select a Default Search Mode like Neural Code Search (NCS).

You’ll also find options for Confirmation Settings (for specific actions), toggles for usage or metrics summaries, and a Default Toolbar for newly saved snippets.

  • Default Layout: Choose your preferred view on launch.

  • Default Search Mode: Select how you search by default.

  • Confirmation Settings: Control dialog prompts.

  • Default Toolbar: Assign a default toolbar to new snippets.

Aesthetics

In the Aesthetics tab, customize the overall appearance of Pieces.

Switch between light or dark mode, select an accent color for UI highlights, and Zoom In/Out to adjust the interface scale.

These controls help you create a comfortable coding environment for extended sessions.

Other Options & Settings Pages

Additional preferences live here, including In-App Notifications (to minimize distractions or stay fully informed), Release Notes (for the latest updates), and Power Tips (for efficiency boosts).

You can also manage Plugins, invite colleagues via Refer a Friend, and control how much crash or compliance data is shared under Telemetry & Diagnostics.

  • In-App Notifications: Decide which alerts you receive.

  • Release Notes: View the most recent updates.

  • Power Tips: Learn shortcuts and advanced capabilities.

  • Plugins: Extend Pieces with extra functionality.

  • Refer a Friend: Invite others to use Pieces.

  • Telemetry & Diagnostics: Configure data sharing preferences.

Updated on