Configuration
Read the guide below to configure the Pieces for JetBrains Plugin to work efficiently in your workflow and adapt to your preferences.
Supported LLMs
We constantly update and configure our plugins and extensions, like the Pieces for JetBrains Plugin, to work with the latest LLMs.
Currently, the Pieces for JetBrains Plugin supports 26 different models:
GPT-3.5-Turbo | GPT-4 | GPT-4-Turbo |
---|---|---|
GPT-4o | GPT-4o-mini | Gemini Pro Chat |
Gemini 1.5 Flash | Gemini 1.5 Pro | Claude 3 Haiku |
Claude 3 Opus | Claude 3 Sonnet | Claude 3.5 Sonnet |
Code Chat Bison | Chat Bison | Mistral 7B |
Phi-2 | Phi-3 Mini 128k | Phi-3 Mini 4k |
Llama 2 7B | Llama 3 8B | Gemma 1.1 7B |
Gemma 1.1 2B | Code Gemma 1.1 7B | Granite 3B & 8B |
Click here for documentation on how to switch the LLM utilized by the Pieces for JetBrains Plugin from within your IDE.
Connect / Disconnect from Personal Cloud
You can connect and disconnect from your personal cloud using Connect to Pieces Cloud
or Disconnect from Pieces Cloud
command in your command palette.
Overriding Commands in JetBrains
If you want to change the shortcuts for any Pieces functionality within your JetBrains IDE, like saving a snippet or generating a shareable link, you can:
-
Navigate to Settings
⌘+,
(macOS) orctrl+,
(Windows/Linux) -
Search for Keymap
-
Click Plugins
-
Find the Pieces folder towards the bottom of the list (in alphabetical order)
-
Double-click or press enter on a Pieces function
-
Select
Add Keyboard Shortcut
and enter your preferred key mapping
Checking Your JetBrains IDE Version
You can easily check the version of your JetBrains IDE by opening up the Settings page using ⌘+,
(macOS) or ctrl+,
(Windows/Linux) and searching for Updates under System Settings.
Other Configurable Settings
There are several other configurable settings related to the functionality of the Pieces for JetBrains Plugin which directly affect usability of some of the plugin’s features. There are also several preferences that you can enable or disable.
Inside your JetBrains IDE, open the Settings
menu using ⌘+,
(macOS) or ctrl+,
(Windows/Linux).
Then, search Pieces
in the search bar, and click on the Pieces
item that’s listed under Tools
.
This will give you access to a boatload of configurable settings for the Pieces for JetBrains Plugin:
Search Everywhere Default Action
Controls the behavior of an opened snippet when accessed from your IDE’s Search Everywhere
command.
This can be adjusted to:
-
Open snippets in markdown view
-
Insert snippets at the current cursor position
-
Open snippets and copy it to clipboard
-
Copy snippets directly to clipboard without opening
Cloud Capabilities
Pieces uses blend of cloud and local AI models, together with other captured context, to enrich your snippets and generate material insights.
You can adjust this AI enrichment setting to primarily utilize Blended
or Local
models.
Code Vision (AI Quick Actions)
You can enable or disable AI Quick Actions (like Pieces: Comment
and Pieces: Explain
) with a checkbox.
You can also change whether you want your selected LLM to respond to the AI Quick Action by generating an output in the same conversation that’s already open in your side panel, or start a new one.
Snippet Enrichment Levels
Select how much metadata should be automatically generated while saving snippets:
-
High (6+)
-
Medium (3-6)
-
Low (1-3)
-
Zero (0)
The information that is included via the enrichment process is related tags, links, code authors, a smart description, and a language tag.
Explored Snippet Insights
You can alter the following behaviors regarding the Explored Snippet Insights
functionality:
-
Insert description result from
Explore Snippet Insights
as a comment above the snippet -
Automatically save explored snippets and material insights
-
Automatically delete explored material when manually saving to Pieces
Read more about Explored Snippets.
Storing Explored Snippet Data
You can choose to have your insight storage location be directly inside your JetBrains IDE specifically (e.g., PyCharm CE), or you can share it across all of your other JetBrains IDEs.
Your saved insights will be available across IntelliJ flavors (e.g., Webstorm, PyCharm) with this setting set to Use Shared Location
by default.
Git Integration
The Pieces for JetBrains Plugin automatically saves and generates metadata and associates it with your snippet, including any relevant information from Git.
You can check or uncheck the following automatically-enabled options:
-
Add commit authors using git history when saving a snippet
-
Add commit links using git history when saving a snippet
-
Add tags using git history when saving a snippet
-
Add commit messages from git history to descriptions when saving a snippet
Link Sharing Behavior
You can adjust whether or not a generated shareable link is saved to your clipboard once it is generated.
Assistive Mechanisms
There are several other assistive mechanisms that are enabled by default with the Pieces for JetBrains Plugin.
-
Enable Autosave
-
Enable Snippet Autocomplete (suggests saved snippets to complete code)
You can also enable or disable the automatic:
-
Saving of code selections used to find Related Materials if none are found
-
Expanding of snippets based on the active file extension (in your IDE’s toolbar)
-
Scrolling behavior that occurs when a series of single-language snippets is automatically expanded
-
Launching of PiecesOS upon project load
-
Sending of usage statistics and analytics to help improve Pieces