- SSH connection to a Workspace is no longer established only once

- authorization wizard automatically goes to a previous screen when an error is encountered during connection to Coder deployment

- action buttons on the token input step were swapped to achieve better keyboard navigation

- authorization wizard automatically goes to a previous screen when an error is encountered during connection to Coder deployment

- URI`project_path` query parameter was renamed to`folder`

To load plugin into the provided Toolbox App, run`./gradlew build copyPlugin`

[](https://discord.gg/coder)

[](https://twitter.com/coderhq)

[](https://github.com/coder/coder-jetbrains-toolbox/actions/workflows/build.yml)

* Windows:`%LocalAppData%/JetBrains/Toolbox/cache/plugins/plugin-id`

* macOS:`~/Library/Caches/JetBrains/Toolbox/plugins/plugin-id`

* Linux:`~/.local/share/JetBrains/Toolbox/plugins/plugin-id`

Put all required .jar files (do not include any dependencies already included with the Toolbox App to avoid possible resolution conflicts),

`extensions.json` and`icon.svg` in this directory.

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

1. Install[JetBrains Toolbox](https://www.jetbrains.com/toolbox-app/). Make sure it's the`2.6.0.40284` release or

above.

2. Launch the Toolbox app and sign in with your JetBrains account (if needed).

You can quickly install the plugin using this JetBrains hyperlink.

👉[Install plugin](jetbrains://gateway/com.coder.toolbox)

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

Alternatively, you can paste`jetbrains://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 plugin

artifact from[JetBrains Marketplace](https://plugins.jetbrains.com/plugin/26968-coder/versions)

or from[Coder's Github Release page](https://github.com/coder/coder-jetbrains-toolbox/releases).

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 the_Gradle_ 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

| Query param| Description| Mandatory|

|------------------|------------------------------------------------------------------------------|-----------|

| url| Your Coder deployment URL (encoded)| Yes|

| token| Coder authentication token| Yes|

| workspace| Name of the Coder workspace to connect to.| Yes|

| agent_id| ID of the agent associated with the workspace| No|

| ide_product_code| JetBrains IDE product code (e.g., GO for GoLand, RR for Rider)| No|

| ide_build_number| Specific build number of the JetBrains IDE to install on the workspace| No|

| folder| Absolute path to the project folder to open in the remote IDE (URL-encoded)| No|

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 plugin

does not automatically start agents if they are offline, so please ensure the selected agent is running before

proceeding.

If`ide_product_code` and`ide_build_number` is missing, Toolbox will only open and highlight the workspace environment

page. Coder Toolbox will attempt to start the workspace if it’s not already running; however, for the most reliable

experience, 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.

}/"JetBrains"/"Toolbox"

val pluginsDir=when {

SystemInfoRt.isWindows-> toolboxCachesDir/"cache"

SystemInfoRt.isLinux||SystemInfoRt.isMac-> toolboxCachesDir

SystemInfoRt.isWindows||

SystemInfoRt.isLinux||

SystemInfoRt.isMac-> toolboxCachesDir

else-> error("Unknown os")

}/"plugins"

version=0.1.3

version=0.1.4

group=com.coder.toolbox

name=coder-toolbox

shouldWaitForAutoLogin:Boolean,

reInitialize:suspend (CoderRestClient,CoderCLIManager)->Unit

) {

context.popupPluginMainPage()

val params= uri.toQueryParameters()

if (params.isEmpty()) {

}

val deploymentURL= params.url()?: askUrl()

if (deploymentURL.isNullOrBlank()) {

}

val agent= getMatchingAgent(params, workspace)

val agent:WorkspaceAgent

try {

agent= getMatchingAgent(params, workspace)

}catch (e:IllegalArgumentException) {

context.logger.error(e,"Can't resolve an agent for workspace$workspaceName from$deploymentURL")

context.showErrorPopup(

MissingArgumentException(

"Can't handle URI because we can't resolve an agent for workspace$workspaceName from$deploymentURL",

e

)

)

}

val status=WorkspaceAndAgentStatus.from(workspace, agent)

if (!status.ready()) {

context.envPageManager.showEnvironmentPage(environmentId,false)

val productCode= params.ideProductCode()

val buildNumber= params.ideBuildNumber()

valprojectPath= params.projectPath()

valprojectFolder= params.projectFolder()

if (!productCode.isNullOrBlank()&&!buildNumber.isNullOrBlank()) {

context.cs.launch {

val ideVersion="$productCode-$buildNumber"

}

job.join()

context.logger.info("launching$ideVersion on$environmentId")

context.ideOrchestrator.connectToIde(environmentId, ideVersion,projectPath)

context.ideOrchestrator.connectToIde(environmentId, ideVersion,projectFolder)

}

}

}

internalfungetMatchingAgent(

parameters:Map<String,String?>,

val agent=

if (!parameters.agentID().isNullOrBlank()) {

agents.firstOrNull { it.id.toString()== parameters.agentID() }

}elseif (!parameters.agentName().isNullOrBlank()) {

agents.firstOrNull { it.name== parameters.agentName() }

}elseif (agents.size==1) {

agents.first()

}else {

if (agent==null) {

if (!parameters.agentID().isNullOrBlank()) {

throwIllegalArgumentException("The workspace\"${workspace.name}\" does not have an agent with ID\"${parameters.agentID()}\"")

}elseif (!parameters.agentName().isNullOrBlank()) {

throwIllegalArgumentException(

"The workspace\"${workspace.name}\"does not have an agent named\"${parameters.agentName()}\"",

)

}else {

throwMissingArgumentException(

"Unable to determine which agent to connect to;one of\"$AGENT_NAME\" or\"$AGENT_ID\" must be set because the workspace\"${workspace.name}\" has more than one agent",

"Unable to determine which agent to connect to;\"$AGENT_ID\" must be set because the workspace\"${workspace.name}\" has more than one agent",

)

}

}

funMap<String,String>.isCoder():Boolean=this[TYPE]=="coder"

funMap<String,String>.url()=this[URL]

funMap<String,String>.token()=this[TOKEN]

funMap<String,String>.workspace()=this[WORKSPACE]

funMap<String,String?>.agentName()=this[AGENT_NAME]

funMap<String,String?>.agentID()=this[AGENT_ID]

funMap<String,String>.ideProductCode()=this[IDE_PRODUCT_CODE]

funMap<String,String>.ideBuildNumber()=this[IDE_BUILD_NUMBER]

funMap<String,String>.projectPath()=this[PROJECT_PATH]

funMap<String,String>.projectFolder()=this[FOLDER]

val tests=

listOf(

Pair(mapOf("agent" to"agent_name"),"9a920eee-47fb-4571-9501-e4b3120c12f2"),

Pair(mapOf("agent_id" to"9a920eee-47fb-4571-9501-e4b3120c12f2"),"9a920eee-47fb-4571-9501-e4b3120c12f2"),

Pair(mapOf("agent" to"agent_name_2"),"fb3daea4-da6b-424d-84c7-36b90574cfef"),

Pair(mapOf("agent_id" to"fb3daea4-da6b-424d-84c7-36b90574cfef"),"fb3daea4-da6b-424d-84c7-36b90574cfef"),

Pair(mapOf("agent" to"agent_name_3"),"b0e4c54d-9ba9-4413-8512-11ca1e826a24"),

Pair(mapOf("agent_id" to"b0e4c54d-9ba9-4413-8512-11ca1e826a24"),"b0e4c54d-9ba9-4413-8512-11ca1e826a24"),

Pair(

mapOf("agent_id" to"9a920eee-47fb-4571-9501-e4b3120c12f2"),

),

Pair(

mapOf("agent_id" to"fb3daea4-da6b-424d-84c7-36b90574cfef"),

),

Pair(

mapOf("agent_id" to"b0e4c54d-9ba9-4413-8512-11ca1e826a24"),

),

Pair(

mapOf(

"agent" to"agent_name",

"agent_id" to"b0e4c54d-9ba9-4413-8512-11ca1e826a24",

),

"b0e4c54d-9ba9-4413-8512-11ca1e826a24",

val tests=

listOf(

Triple(emptyMap(),MissingArgumentException::class,"Unable to determine"),

Triple(mapOf("agent" to""),MissingArgumentException::class,"Unable to determine"),

Triple(mapOf("agent_id" to""),MissingArgumentException::class,"Unable to determine"),

Triple(mapOf("agent" tonull),MissingArgumentException::class,"Unable to determine"),

Triple(mapOf("agent_id" tonull),MissingArgumentException::class,"Unable to determine"),

Triple(mapOf("agent" to"ws"),IllegalArgumentException::class,"agent named"),

Triple(mapOf("agent" to"ws.agent_name"),IllegalArgumentException::class,"agent named"),

Triple(mapOf("agent" to"agent_name_4"),IllegalArgumentException::class,"agent named"),

Triple(mapOf("agent_id" to"not-a-uuid"),IllegalArgumentException::class,"agent with ID"),

Triple(mapOf("agent_id" to"ceaa7bcf-1612-45d7-b484-2e0da9349168"),IllegalArgumentException::class,"agent with ID"),

Triple(

mapOf("agent_id" to"ceaa7bcf-1612-45d7-b484-2e0da9349168"),

IllegalArgumentException::class,

),

Triple(

mapOf(

val ws=DataGen.workspace("ws", agents= oneAgent)

val tests=

listOf(

Triple(mapOf("agent" to"ws"),IllegalArgumentException::class,"agent named"),

Triple(mapOf("agent" to"ws.agent_name_3"),IllegalArgumentException::class,"agent named"),

Triple(mapOf("agent" to"agent_name_4"),IllegalArgumentException::class,"agent named"),

Triple(mapOf("agent_id" to"ceaa7bcf-1612-45d7-b484-2e0da9349168"),IllegalArgumentException::class,"agent with ID"),

Triple(

mapOf("agent_id" to"ceaa7bcf-1612-45d7-b484-2e0da9349168"),

IllegalArgumentException::class,

),

)

tests.forEach {

Triple(mapOf("agent" tonull),IllegalArgumentException::class,"has no agents"),

Triple(mapOf("agent_id" tonull),IllegalArgumentException::class,"has no agents"),

Triple(mapOf("agent" to"agent_name"),IllegalArgumentException::class,"has no agents"),

Triple(mapOf("agent_id" to"9a920eee-47fb-4571-9501-e4b3120c12f2"),IllegalArgumentException::class,"has no agents"),

Triple(

mapOf("agent_id" to"9a920eee-47fb-4571-9501-e4b3120c12f2"),

IllegalArgumentException::class,

),

)

tests.forEach {