Configuring PiecesOS
Read the documentation below on configuring PiecesOS with the Pieces for Visual Studio Extension to customize it to your exact needs.
Supported LLMs
We continuously update and optimize our plugins and extensions to ensure compatibility with the latest LLMs.
Read the documentation to learn how to switch your Pieces Copilot Runtime (LLM) used by the Pieces for Visual Studio Extension directly within your IDE.
Opening Pieces Settings
To open the Pieces Settings in the Pieces for Visual Studio Extension, follow these steps:
Open the Command Palette
Press ctrl+shift+p to open the Command Palette in Visual Studio.
Search for User Preferences
Type Pieces > Pieces for Visual Studio > User Preferences in the search bar.
Open and Adjust Settings
Select the command to access the Pieces settings and make adjustments as needed.
Overriding Commands in Visual Studio
To modify the keyboard shortcuts for Pieces functionality in Visual Studio, such as saving a snippet or launching the Copilot, follow these steps:
Open the Options Menu
Navigate to Tools > Options from the top toolbar in Visual Studio
Access Keyboard Settings
In the Options window, expand the Environment section and select Keyboard
Search for a Pieces Command
Use the search bar to find the Pieces command you want to modify, such as Pieces.SaveToPieces
Assign a New Shortcut
Select the command from the list and enter your preferred shortcut in the Press shortcut keys field
Save Your Shortcut
Ensure your new shortcut doesn’t conflict with existing Visual Studio commands, then click Assign to save your changes
This process enables you to customize keyboard shortcuts to fit your workflow seamlessly.
Settings Overview
Analytics
Manage how Pieces collects and processes data:
-
Analytics Privacy: Set your privacy level (e.g., OPEN or ANONYMOUS).
-
Anonymous Analytics: Enable or disable the collection of anonymous analytics.
-
Exception Analytics: Toggle tracking of application exceptions.
-
Usage Analytics: Track general usage patterns to improve functionality.
CodeLens
Customize the behavior of CodeLens features in Visual Studio:
-
Enabled: Turn CodeLens integration on or off.
-
Refresh Delay: Adjust the refresh rate (in milliseconds) for CodeLens updates.
Editing
Modify editor behavior related to snippets:
- Close Snippet Editor On Save: Automatically close the snippet editor after saving changes.
Enrichment
Set the level of metadata added to saved snippets:
- Enrichment Value: Choose the level of snippet enrichment (e.g., Low, Medium, High).
Miscellaneous
Manage miscellaneous settings for Pieces functionality:
-
DetectedPiecesOSPort: Displays the detected port where PiecesOS is running.
-
PiecesOSPort: Shows the port used for PiecesOS communication.
PiecesOS
Control integration and communication with the PiecesOS application:
-
Base API Path: Specifies the API path (default:
http://localhost:39300). -
Base API Port: Displays the port PiecesOS is running on (default:
39300). -
Capabilities: Selects the type of models used (e.g., Cloud, Local, Blended).
-
Launch Pieces OS on Interaction: Define whether PiecesOS should launch upon user interaction.
-
Launch PiecesOS on Startup: Enable or disable automatic startup of PiecesOS.
Searching
Adjust search-related functionality:
-
Search Action: Set the default action when searching (e.g., Overview).
-
Search By: Define the search criteria (e.g., All).
-
Search Display: Configure how search results are displayed (e.g., NameTagsAndSnippet).
Sharing
Manage sharing settings for snippets:
- Clipboard Links: Enable or disable the creation of clipboard links for shared snippets.
Terminal
Set terminal-specific preferences:
- Use Integrated Terminal: Toggle the use of the integrated terminal in Visual Studio.
For additional support resources, check out our troubleshooting guide.