Bitbucket Linky

Compatible with: IntelliJ IDEA PhpStorm WebStorm PyCharm RubyMine AppCode CLion GoLand DataGrip Rider MPS Android Studio
Nov 27, 2017
96 292

Bitbucket Linky provides easy navigation to Atlassian Bitbucket.

Linky automatically detects repositories hosted on Bitbucket Cloud or Bitbucket Server.

Both Git and Mercurial repositories are supported. In most cases, no configuration is required. However, if Linky can't detect your repository automatically, you can manually point it to the repository in the IDE settings.

Linky uses Git integration and hg4idea plugins to integrate with Git and Mercurial, respectively. These plugins come with every JetBrains IDE, but you might need to enable them in order to use Bitbucket Linky actions. Both dependencies are optional though, so you can enable only one for the VCS you are using.

Please note that Linky is not officially supported by Atlassian.

Linky provides the following actions in your project:

Copy the link / Open in the Browser
Copies or opens a link to the selected file or commit in Bitbucket. Provides an easy way to generate link to a specific place in the code or to navigate to your repository from the IDE.
Shortcuts:

  • Copy link: Ctrl+Shift+X,C on Windows / Cmd+Shift+X,C on Mac
  • Open in Browser: Ctrl+Shift+X,B on Windows / Cmd+Shift+X,B on Mac
Available for:
  • Files opened in the editor, including historical versions. Selected lines are included in the link.
  • Editor tabs.
  • Files in the Project tree tool window.
  • Files in the commit details panel in the Version Control tool window.
  • Files shown in the diff window.
  • Commits in the annotation gutter.
  • Commits in the VCS log shown in the Version Control tool window.
  • Pull Requests in the Related Pull Requests tool window.
Note: Linky will show a warning if the link you created is pointing to a commit that has not been pushed yet.

Find related Pull Requests
Shows a list of all Pull Requests which include the selected commit.
Available for Bitbucket Cloud repositories only:

  • Commits in the annotation gutter.
  • Commits in the VCS log shown in the Version Control tool window.
Notes:
  • Authentication with Bitbucket Cloud is required. Linky will suggest to configure OAuth when you trigger this action for the first time. OAuth refresh and access tokens will be saved in your IDE's preferred password storage.
  • Pull Request Commit Links add-on for Bitbucket Cloud is required on either your account or the account that owns the repository you're working on. Linky will suggest to install that add-on if it is unable to find it when you trigger this action.

Open Pull Request creation page in the Browser
Opens the Pull Request creation page in Bitbucket with pre-filled source and target branches. Source branch will be the branch your local repository is at, target branch will be either the default repository branch, or the branch you manually set for this repository in the Linky configuration.
Shortcut: Ctrl+Shift+X,P on Windows / Cmd+Shift+X,P on Mac
Available:

  • Anywhere in the project via the shortcut if the project contains only one repository hosted on Bitbucket.
  • Otherwise, only on current (non-historical) versions of the files in your repository, including editor tabs and Project tree.

Contributors
Huge thanks to Brent Plump, Zaki Salleh and Piotr WilczyƄski!

Download plugin

Recent change notes

5.0: released on 27.11.2017

  • New: Create Bitbucket Snippet action
  • Change: The action that triggered OAuth dance is resumed after OAuth is configured
  • Change: Simplify link configuration settings

4.2: released on 20.11.2017

  • Change: Brand new icons
  • New: Double click on the related Pull Request opens it in the Browser
  • Fix: Handle Pull Requests with unknown author (e.g. deleted user)

4.1: released on 27.10.2017

  • Fix: Crash on missing optional dependency
  • Fix: Speed up revision status check for Git repositories
  • Fix: Wrong revision status warning for commit actions

4.0: released on 25.10.2017

  • New: Find related Pull Requests action
  • Change: Update Bitbucket icons

3.6: released on 12.10.2017

  • Fix: Discovery of a wrong Bitbucket instance type
  • Fix: Crash on certain type of Git remote repository URL format
  • Fix: Update plugin description to mention dependencies on Git and Mercurial plugins

3.5: released on 12.09.2017

  • Fix: Compatibility issues with Hg plugin
  • New: Create Pull Request action is available in VCS tool window for projects with single repository
  • New: Linky warns if link was created for a commit that has not been pushed to the remote
  • Change: Low level logs of HTTP requests during Bitbucket discovery

3.4: released on 06.05.2017

  • Fix: Remote selection algorithm in case of multiple registered remotes is now deterministic
  • New: Configurable remote selection strategy: automatic selection or fixed remote
  • New: Linky actions added to the VCS log, changes viewer and diff viewer

3.3: released on 22.03.2017

  • New: Linky actions available in older revisions of a file

3.2: released on 02.03.2017

  • Fix: Compatibility issues with IntelliJ 2016.1 and 2016.2

3.1: released on 23.02.2017

  • Fix: Branch name escaping in Create Pull Request link
  • Fix: File line reference in Commit link for Bitbucket Cloud

3.0: released on 19.02.2017

  • New: Copy commit link action
  • New: Configuration screens for manual linking to Bitbucket instance
  • New: Configurable default target branch for Create pull request action
  • Change: Update action icons
  • Change: Revamp discovered hosting properties storage
  • Change: Change the way Bitbucket is discovered

2.4: released on 05.09.2016

  • Fix: Handle special characters in branch name (applicable to 'Create Pull Request' action)
  • New: Support git:// protocol scheme

2.3: released on 26.05.2016

  • New: Introduced 'Create Pull Request' action

2.2: released on 04.03.2016

  • Fix: Revert changes to line number inclusion/exclusion

2.1: released on 30.01.2016

  • Fix: Fix URL construction on Windows
  • Fix: Fix Hg repositories discovery
  • New: Bitbucket Cloud development environment support

2.0: released on 27.01.2016

  • New: Include the selected file and line in the link to the Commit view
  • Change: Improve text selections handling
  • Change: Link points to the commit hash instead of the branch name, whenever possible
  • Change: Optimize hosting application discovery process

1.6: released on 15.01.2016

  • Fix: Optional dependencies on Git and Hg plugins
  • Fix: Support spaces and other special characters in file path
  • Change: User-centric URL for Bitbucket Server personal projects

1.5: released on 01.01.2016

  • New: Bitbucket actions are available during indexing time
  • Fix: Support for multiple mercurial repositories within one project
  • Fix: Bitbucket actions are disabled for ignored and untracked files

1.4: released on 19.11.2015

  • Fix: Support for more types of remote URLs.

1.3: released on 17.11.2015

  • New: Bitbucket rediscovery attempts
  • Change: First keystroke of shortcuts mapped to Ctrl/Cmd+Shift+X

1.2: released on 03.11.2015

  • Fix: Mercurial commit hash handling
  • Change: Shortcuts have single second keystroke

1.0: released on 03.11.2015

  • New: 'Copy link' and 'Open' actions for files and 'Open' action for commits shown in the gutter