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.

The Pieces for JetBrains Plugin currently supports 54 different cloud and local models.

Read documentation on how to switch the LLM utilized by the Pieces for JetBrains Plugin from within your IDE.

Opening Pieces Settings

To open the Pieces Settings in the Pieces for JetBrains Plugin, follow these steps:

1

Open the Settings Menu

Inside your JetBrains IDE, open the Settings menu using ⌘+, (macOS) or ctrl+, (Windows/Linux)

2

Search for Pieces

Search for Pieces in the search bar, and click on the Pieces item under Tools

3

Adjust Settings

This gives you access to many configurable settings for the Pieces for JetBrains Plugin

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:

1

Open Settings

Navigate to Settings ⌘+, (macOS) or ctrl+, (Windows/Linux)

2

Search for Keymap

Enter Keymap into the search bar

3

Go to Plugins

Click on the Plugins section

4

Locate Pieces Folder

Find the Pieces folder towards the bottom of the list (in alphabetical order)

5

Open Pieces Function

Double-click or press enter on a Pieces function

6

Assign Keyboard Shortcut

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.

Settings Overview

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.

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.

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.

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

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

Updated on