JetBrains Space Help

Space Plugin for IntelliJ-based IDEs

Space plugin is intended for JetBrains Space members that use IntelliJ-based IDEs to work on their projects. It links your IDE with your organization at JetBrains Space and lets you:

All of which right from your IDE.

Space plugin works across all JetBrains IDEs of the latest version (2019.3+). The plugin comes bundled with IntelliJ IDEA 2021.1. For older versions and other JetBrains IDEs, you need to install it.

Install Space plugin

  1. Make sure your JetBrains IDE is version 2019.3 or newer. If you're using IntelliJ IDEA 2021.1 or newer, you don't need to install the plugin — it comes with your IDE installation. Otherwise, follow the steps below.

  2. Open your IDE and go to File → Settings.

  3. In the Settings dialog window, select Plugins from the left pane.

  4. Select the Marketplace tab:

  5. Find JetBrains Space plugin on the list and click Install.

  6. To activate the plugin, restart your IDE.

Log in to Space

Before you can start using Space plugin, you need to provide it with your Space organization address and log in to Space.

  1. In your IDE, go to Tools → Space → Log in to Space:

    pluginToolsSpaceLogin.png
  2. Enter the address of your Space organization website, e.g https://mycompany.jetbrains.space (Make sure to enter the full URL starting with https://):

    pluginOrganizationURL.png
  3. The Space login screen will open in a browser where you can enter your Space credentials. If you're successfully logged in, your Space avatar will be displayed in the IDE:

    pluginLoggedIn.png

View and clone repositories

View all projects and repositories hosted in your Space organization then clone a repository you want to contribute to.

Before you can clone a repository, you need to upload your SSH public key to Space or set up an HTTP password (depending on the authentication methods used in repositories)

You may be also required to have a GPG key for signing your commits.

See Git Keys and Passwords for instructions.

Now you can view and clone repositores from your IDE:

  1. In your IDE, go to Tools → Space → Clone Repository.

    A list of projects and repositories will be displayed.

  2. To clone a repository to your machine, select it from the list and click OK:

    pluginClone.png

Review code

Space Code Review tool window lets you browse and search all code reviews for the current project, view and leave comments, examine and accept changes.

To open the Space Code Reviews tool window, click the respective sidebar menu item on the left or go to Tools → Space → Code Reviwes:

pluginOpenCodeReviewWindow.png

Use the quick filters to display:

  • Open or closed code reviews.

  • Reviews that include your changes.

  • Reviews then need your attention.

  • Changes that you're expected to review.

  • Reviews assigned to you.

pluginCodeReviewFilters.png

Click on the review to open it:

pluginCodeReviewSelect.png

On the left, you can see the code review details, such as who the authors and reviewers are, and when it was created. On the right you can see the review timeline including comments:

pluginCodeReviewTimeline.png

Inspect changes

After you open a code review, you’ll see a list of files that were added, changed, or removed. Click on a file to open it in a diff viewer and examine changes:

pluginCodeReviewOpenFileDiff.png

Leave comments and replies

In the diff viewer, you can reply to comments left by others and add new line comments. Just hover over a line of code and click on a plus sign:

pluginCodeReviewLineComments.png

Comments are saved as a draft not visible to others. They will be sent at the end of your turn in the code review process. To send your comment immediately, go to the Timeline and click Post now.

On the Timeline view, you can also leave general, commit-level comments and reply to comments left by other participants:

pluginCodeReviewPostNow.png

Finish your turn: Accept changes or Wait for response

Once you’re done reviewing changes, you can finish your turn in the code review process. In Details view, you can choose to:

  • Accept Changes — when everything is fine and you are ready to approve the changes.

  • Wait for Response — when you have questions, concerns or suggestions, or some other reasons not to approve the changes.

pluginCodeReviewFinish.png

Any of these options will end your turn in the code review process. The draft comments you added while looking through code will be posted and other participants notified that you're done.

Open project checklists, issues, and commits in browser

Quickly navigate to the issues, checklists, or commits associated with the project you're currently working on in your IDE.

To open checklists or issues:

  1. In your IDE, go to Tools → Space.

  2. Choose what you'd like to see:

    • Checklists

    • or Issues

    The selected category will open in your browser.

When viewing a commit log in your IDE, instantly open a commit in Space to comment on it, start a code review, or contact its author.

To open commits:

  1. In your IDE's Version Control tool window open the Log tab.

  2. Right-click a commit and choose Open in Space:

    pluginOpenCommit.png

Inspect Automation jobs and write scripts

A repository hosted in Space contains a .space.kts file that describes Automation jobs with Kotlin scripts.

The Space plugin gives you additional functionality for creating and editing these scripts:

  • Code completion

  • Syntax highlighting

  • Move common logic into functions

  • Use the Extract method refactoring to move existing script code into a separate function.

Last modified: 13 April 2021