Refactor for Toolbox

I kept our core code intact as much as possible, but this is technically
an entirely different plugin now.

CONTRIBUTING.md

@@ -2,87 +2,54 @@
 
 ## Architecture
 
-The Coder Gateway plugin uses Gateway APIs to SSH into the remote machine,
-download the requested IDE backend, run the backend, then launches a client that
-connects to that backend using a port forward over SSH. If the backend goes down
-due to a crash or a workspace restart, it will restart the backend and relaunch
-the client.
+The Coder Toolbox Gateway plugins provides some login pages, after which
+it configures SSH and gives Toolbox a list of environments with their
+host names. Toolbox then handles everything else.
 
-There are three ways to get into a workspace:
+There are two ways to get into a workspace:
 
 1. Dashboard link.
-2. "Connect to Coder" button.
-3. Using a recent connection.
-
-Currently the first two will configure SSH but the third does not yet.
+2. Through Toolbox.
 
 ## Development
 
-To manually install a local build:
-
-1. Install [Jetbrains Gateway](https://www.jetbrains.com/remote-development/gateway/)
-2. Run `./gradlew clean buildPlugin` to generate a zip distribution.
-3. Locate the zip file in the `build/distributions` folder and follow [these
-   instructions](https://www.jetbrains.com/help/idea/managing-plugins.html#install_plugin_from_disk)
-   on how to install a plugin from disk.
+You can get the latest build of Toolbox with Gateway support from our shared 
+Slack channel with JetBrains. Make sure you download the right version (check
+[./gradle/libs.versions.toml](./gradle/libs.versions.toml)).
 
-Alternatively, `./gradlew clean runIde` will deploy a Gateway distribution (the
-one specified in `gradle.properties` - `platformVersion`) with the latest plugin
-changes deployed.
+To load the plugin into Toolbox, close Toolbox, run `./gradlew build copyPlugin`,
+then launch Toolbox again.
 
-To simulate opening a workspace from the dashboard pass the Gateway link via
-`--args`. For example:
+To simulate opening a workspace from the dashboard you can use something like
+`xdg-open` to launch a URL in this format:
 
 ```
-./gradlew clean runIDE --args="jetbrains-gateway://connect#type=coder&workspace=dev&agent=coder&folder=/home/coder&url=https://dev.coder.com&token=<redacted>&ide_product_code=IU&ide_build_number=223.8836.41&ide_download_link=https://download.jetbrains.com/idea/ideaIU-2022.3.3.tar.gz"
+jetbrains://gateway/com.coder.gateway/connect?workspace=dev&agent=coder&url=https://dev.coder.com&token=<redacted>
 ```
 
-Alternatively, if you have separately built the plugin and already installed it
-in a Gateway distribution you can launch that distribution with the URL as the
-first argument (no `--args` in this case).
-
 If your change is something users ought to be aware of, add an entry in the
 changelog.
 
 Generally we prefer that PRs be squashed into `main` but you can rebase or merge
 if it is important to keep the individual commits (make sure to clean up the
 commits first if you are doing this).
 
+We are using `ktlint` to format but this is not currently enforced.
+
 ## Testing
 
 Run tests with `./gradlew test`. By default this will test against
 `https://dev.coder.com` but you can set `CODER_GATEWAY_TEST_DEPLOYMENT` to a URL
 of your choice or to `mock` to use mocks only.
 
-There are two ways of using the plugin: from standalone Gateway, and from within
-an IDE (`File` > `Remote Development`).  There are subtle differences so it
-makes usually sense to test both.  We should also be testing both the latest
-stable and latest EAP.
-
-## Plugin compatibility
-
-`./gradlew runPluginVerifier` can check the plugin compatibility against the specified Gateway. The integration with Github Actions is commented until [this gradle intellij plugin issue](https://github.com/JetBrains/gradle-intellij-plugin/issues/1027) is fixed.
+Some investigation is needed to see what options we have for testing code 
+directly tied to the UI, as currently that code is untested.
 
 ## Releasing
 
-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.
+We do not yet have a release workflow yet, but it will look like:
 
-## `main` vs `eap` branch
-
-Sometimes there can be API incompatibilities between the latest stable version
-of Gateway and EAP ones (Early Access Program).
-
-If this happens, use the `eap` branch to make a separate release. Once it
-becomes stable, update the versions in `main`.
-
-## Supported Coder versions
-
-`Coder Gateway` includes checks for compatibility with a specified version
-range. A warning is raised when the Coder deployment build version is outside of
-compatibility range.
-
-At the moment the upper range is 3.0.0 so the check essentially has no effect,
-but in the future we may want to keep this updated.
+1. Check that the changelog lists all the important changes.
+2. Update the extension.json version and changelog header.
+3. Tag the commit made from the second step with the version.
+4. Publish the resulting draft release after validating it.

README.md

@@ -1,37 +1,33 @@
-# Coder Gateway Plugin
-
-[!["Join us on
-Discord"](https://img.shields.io/badge/join-us%20on%20Discord-gray.svg?longCache=true&logo=discord&colorB=purple)](https://discord.gg/coder)
-[![Twitter
-Follow](https://img.shields.io/twitter/follow/CoderHQ?label=%40CoderHQ&style=social)](https://twitter.com/coderhq)
-[![Coder Gateway Plugin Build](https://github.com/coder/jetbrains-coder/actions/workflows/build.yml/badge.svg)](https://github.com/coder/jetbrains-coder/actions/workflows/build.yml)
-
-<!-- Plugin description -->
-The Coder Gateway plugin lets you open [Coder](https://github.com/coder/coder)
-workspaces in your JetBrains IDEs with a single click.
-
-**Manage less**
-
-- Ensure your entire team is using the same tools and resources
-  - Rollout critical updates to your developers with one command
-- Automatically shut down expensive cloud resources
-- Keep your source code and data behind your firewall
-
-**Code more**
-
-- Build and test faster
-  - Leveraging cloud CPUs, RAM, network speeds, etc.
-- Access your environment from any place on any client (even an iPad)
-- Onboard instantly then stay up to date continuously
-
-<!-- Plugin description end -->
-
-## Getting Started
-
-1. Install [Jetbrains Gateway](https://www.jetbrains.com/remote-development/gateway/)
-2. [Install this plugin from the JetBrains Marketplace](https://plugins.jetbrains.com/plugin/19620-coder/).
-   Alternatively, if you launch a JetBrains IDE from the Coder dashboard, this
-   plugin will be automatically installed.
-
-It is also possible to install this plugin in a local JetBrains IDE and then use
-`File` > `Remote Development`.
+# Coder Toolbox Gateway Plugin
+
+[!["Join us on
+Discord"](https://img.shields.io/badge/join-us%20on%20Discord-gray.svg?longCache=true&logo=discord&colorB=purple)](https://discord.gg/coder)
+[![Twitter
+Follow](https://img.shields.io/twitter/follow/CoderHQ?label=%40CoderHQ&style=social)](https://twitter.com/coderhq)
+[![Coder Gateway Plugin Build](https://github.com/coder/jetbrains-coder/actions/workflows/build.yml/badge.svg)](https://github.com/coder/jetbrains-coder/actions/workflows/build.yml)
+
+<!-- Plugin description -->
+The Coder Toolbox Gateway plugin lets you open [Coder](https://github.com/coder/coder)
+workspaces from Toolbox with a single click.
+
+**Manage less**
+
+- Ensure your entire team is using the same tools and resources
+  - Rollout critical updates to your developers with one command
+- Automatically shut down expensive cloud resources
+- Keep your source code and data behind your firewall
+
+**Code more**
+
+- Build and test faster
+  - Leveraging cloud CPUs, RAM, network speeds, etc.
+- Access your environment from any place on any client (even an iPad)
+- Onboard instantly then stay up to date continuously
+
+<!-- Plugin description end -->
+
+## Getting Started
+
+Gateway in Toolbox and this plugin are still in development. Steps to
+use Toolbox with Coder will come soon, but see the contributing doc 
+if you want to contribute.