Repository files navigation

Connects your JetBrains IDE to Coder workspaces

To install this plugin using JetBrains Toolbox, follow the steps below.

1. InstallJetBrains Toolbox. Make sure it's the2.6.0.40284 release orabove.
2. Launch the Toolbox app and sign in with your JetBrains account (if needed).

You can quickly install the plugin using this JetBrains hyperlink:

👉 jetbrains://gateway/com.coder.toolbox

This will open JetBrains Toolbox and prompt you to install the Coder Toolbox plugin automatically.

Alternatively, you can pastejetbrains://gateway/com.coder.toolbox into a browser.

There are two ways Coder Toolbox plugin can be installed. The first option is to manually download the pluginartifact fromJetBrains Marketplaceor fromCoder's Github Release page.

The next step is to copy the zip content to one of the following locations, depending on your OS:

• Windows:%LocalAppData%/JetBrains/Toolbox/plugins/com.coder.toolbox
• macOS:~/Library/Caches/JetBrains/Toolbox/plugins/com.coder.toolbox
• Linux:~/.local/share/JetBrains/Toolbox/plugins/com.coder.toolbox

Alternatively, you can install it using theGradle tasks included in the project:

./gradlew cleanAll build copyPlugin

Make sure Toolbox is closed before running the command.

You can use specially crafted JetBrains Gateway URIs to automatically:

1. Open Toolbox

2. Install the Coder Toolbox plugin (if not already installed)

3. Connect to a specific Coder deployment using a URL and a token.

4. Select a running workspace

5. Install a specified JetBrains IDE on that Workspace

6. Open a project folder directly in the remote IDE

jetbrains://gateway/com.coder.toolbox?url=https%3A%2F%2Fdev.coder.com&token=zeoX4SbSpP-j2qGpajkdwxR9jBdcekXS2&workspace=bobiverse-bob&agent=dev&ide_product_code=GO&ide_build_number=241.23774.119&folder=%2Fhome%2Fcoder%2Fworkspace%2Fhello-world-rsjetbrains://gateway/com.coder.toolbox?url=https%3A%2F%2Fj5gj2r1so5nbi.pit-1.try.coder.app%2F&token=gqEirOoI1U-FfCQ6uj8iOLtybBIk99rr8&workspace=bobiverse-riker&agent=dev&ide_product_code=RR&ide_build_number=243.26053.17&folder=%2Fhome%2Fcoder%2Fworkspace%2Fhello-world-rs

jetbrains://gateway/com.coder.toolbox  ?url=http(s)://<your-coder-deployment>  &token=<auth-token>  &workspace=<workspace-name>  &agent_id=<agent--id>  &ide_product_code=<IDE-code>  &ide_build_number=<IDE-build>  &folder=<absolute-path-to-a-project-folder>

If only a single agent is available, specifying an agent ID is optional. However, if multiple agents exist,you must provide either the ID to target a specific one. Note that this version of the Coder Toolbox plugindoes not automatically start agents if they are offline, so please ensure the selected agent is running beforeproceeding.

Ifide_product_code andide_build_number is missing, Toolbox will only open and highlight the workspace environmentpage. Coder Toolbox will attempt to start the workspace if it’s not already running; however, for the most reliableexperience, it’s recommended to ensure the workspace is running prior to initiating the connection.

1. Check that the changelog lists all the important changes.
2. Update the gradle.properties version.
3. Publish the resulting draft release after validating it.
4. Merge the resulting changelog PR.