Overview

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

You can customize the Pieces Desktop App to your coding workflow by integrating external services or customizing the interface.

Accessing Settings

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

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

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 settings are now part of the Account tab and control 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.

Long-Term Memory

The Long-Term Memory settings allow you to manage the Long-Term Memory Engine, control which applications Pieces can access, manage system permissions, optimize performance, and clear stored data.

  • Long-Term Memory Engine: Toggle the engine on or off to control workflow context capture.

  • App Access Control: Manage which applications the Long-Term Memory Engine interacts with.

  • System Permissions: Manage accessibility and screen permissions for LTM.

  • Optimize System RAM Usage: Unload local machine learning models from memory.

  • Clear LTM Data: Remove persisted data captured by the Long-Term Memory Engine.

Models

The Models settings allow you to configure processing modes, set up local model runtime with Ollama, and control which AI models are available for use in Pieces.

  • Processing Mode: Choose between Cloud, Local, or Blended processing modes.

  • Ollama Status: Check if Ollama is installed, activated, and ready for local model processing.

  • Model Management: Enable or disable specific AI models from different providers (OpenAI, Anthropic, Google, Microsoft, Meta, IBM, etc.).

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.

Appearance

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

Switch between light or dark mode, select an accent color for UI highlights, adjust font size and weight, and configure visual density to control spacing and layout.

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

Troubleshooting

The Troubleshooting settings provide access to support resources, documentation links, version information, and feedback channels.

You can view PiecesOS and Desktop App version information, check for updates, access product documentation, report issues on GitHub, book support calls, and control how much crash or compliance data is shared under Privacy settings in Account.

  • Online Resources: Access product documentation and GitHub issues.

  • Get In Touch: Book support calls, contact the team, or visit the support hub.

  • PiecesOS Information: View version, port, and check for updates.

  • Desktop App Information: View version, platform details, and check for updates.

  • Privacy: Configure telemetry and diagnostics settings (found in Account settings).