Configuration

---

Settings, Models, and More

Learn how to configure the Pieces for VS Code Extension—from choosing your preferred LLM to customizing settings, shortcuts, and snippet behaviors.

Supported LLMs

We constantly update and configure our plugins and extensions to work with the latest LLMs.

The Pieces for VS Code Extension currently supports over 54 different LLMs.

Read documentation on how to switch your Pieces Copilot Runtime (LLM) utilized by the Pieces for VS Code Extension within your IDE.

Opening Pieces Settings

To open the Pieces Settings in the Pieces for VS Code Extension, follow these steps:

You can also access Pieces Settings in the bottom-left corner of the screen, where it says Pieces Settings.

Overriding Commands in VS Code

If you’d like to adjust the keyboard shortcuts for Pieces functionality in VS Code, such as saving a snippet or previewing markdown, follow these steps:

Settings Overview

Below is a breakdown of each adjustable setting (preferences, behaviors, views, etc.) you can find in the Pieces for VS Code Extension, broken down by section.

Snippet Preferences

Adjustable settings specific to Pieces Drive, like code snippets, and other material-related action behavior.

Add Snippets

To import your User Snippets from VS Code to Pieces Drive, click Import User Snippets to Pieces.

This will seamlessly bring your custom snippets into Pieces Drive, making them available across your projects.

Pieces Autocomplete

This setting enables or disables Pieces Autocomplete within the Pieces extension, which is a feature that suggests pieces of saved code from your Pieces Drive where it makes sense to use them.

To enable or disable auto-complete, check or uncheck the box in this section of the VS Code settings.

To modify the auto-complete key:

Auto-Expansion

Enabling this option will expand your snippet list to match the programming language of your active file, making it easier to find relevant snippets as you code.

Automatically Copy Link

This setting automatically copies any generated Pieces link. When enabled, links are ready to share instantly, so you don’t need to manually copy them.

Auto-Save

With auto-save enabled, Pieces will automatically save frequently used snippets as you work to Pieces Drive.

This helps reduce the number of snippets you need to save manually and makes it easier to revisit the code you use often.

Display

Control what displays in your snippet list:

• Name: Shows the snippet title

• Description: Shows the snippet’s description

• Preview: Shows a code preview for a glance at the snippet’s contents

Auto-Save Related Materials Selection

Check this box if you’d like any code selected for related materials search to be saved automatically to your Pieces repository.

Git Context

This setting allows you to add Git context to your snippets. Choose if you’d like to include details from your Git history, such as commit links and authors, to better track where snippets originated.

Copilot Preferences

Adjustable preferences related specifically to Pieces Copilot and LLM runtime usage.

Cloud Capabilities

Choose the type of ML models you’d like the Pieces Copilot to use:

• Cloud: For cloud-based models

• Local: For on-device models

• Blended: A mix of cloud and local

To learn more about the types of ML models and their privacy implications, visit our documentation.

Search

You can adjust the default Pieces Copilot search behavior in a few different ways.

1. Search By

Pick your search parameters! In Search By, you can decide if your search will match the characters in your snippets' titles, tags, code contents, or combinations of the three.

2. Search Display

Select what you'd like to display in your search results.

• title, tags, and code

• title, tags, and description

3. Search Result Action

Choose what you want to happen when you select a search result.

• Open in Overview

• Insert Snippet at Cursor

• Open in Overview and Copy to Clipboard

• Copy to Clipboard

Pieces Settings

Launch PiecesOS

If PiecesOS isn’t running, launch it directly from this settings page instead of opening it from your Applications folder.

Notifications

Customize your notification preferences for a more streamlined experience:

• All Notifications: Receive all types of notifications, including successes and suggestions.

• Only Critical Notifications: Only critical alerts, like failures, will be shown.

Other Configurable Settings

Close Snippet Editor On Save

If enabled, this setting will automatically close the snippet editor window when you’ve saved the updated snippet.

Telemetry

Uncheck this box to opt out of sharing analytics with the Pieces development team.

You can also read up on our privacy policy and usage statements for more information about what data is and isn’t collected.

.JSON-Adjustable Settings

All configurable settings for the Pieces for VS Code Extension are available in the settings.json file, accessible through the Pieces Settings window.

---

---

Once you've edited the contents of the settings.json file (shown below) to your preferences, simply save the file and restart VS Code for your changes to take effect.

Copy{
    "files.autoSave": "afterDelay",
    "go.toolsManagement.autoUpdate": true,
    "workbench.iconTheme": "vscode-icons",
    "git.autofetch": true,
    "gitlens.graph.minimap.enabled": false,
    "workbench.colorCustomizations": {},
    "markdown-preview-enhanced.alwaysShowBacklinksInPreview": false,
    "markdown-preview-enhanced.enablePreviewZenMode": false,
    "update.showReleaseNotes": false,
    "editor.inlineSuggest.suppressSuggestions": true,
    "pieces.cloudCapabilities": "Blended",
    "pieces.telemetry": true,
    "pieces.OS.launchOnStartup": "Yes",
    "pieces.launchPiecesOS": null
}

You can save the .json file with ⌘+s (macOS) or ctrl+s (Windows/Linux).

There's no need to use Save As, since file already exists—you're simply updating it with your new settings, which come with the Pieces for VS Code Extension.

---

For additional support resources, check out our troubleshooting guide.