# Bitbucket Search for Raycast

URL: https://www.raycast.com/Francois/bitbucket

> The extension allow you to quickly access repositories, pipelines and pull-requests in Bitbucket

- Install: raycast://extensions/Francois/bitbucket
- Author: [Fexwçofa GC](https://www.raycast.com/Francois)
- Installs: 823
- Updated: 2022-04-20
- Source: https://github.com/raycast/extensions/tree/09173643b164442e34ce743b45e270a503c04a20/extensions/bitbucket/

## Commands

- **Search Repositories**: Showing bitbucket results on repositories search
- **Search My Open Pull Requests**: Showing open pull requests for the current user

## README

<div align="center">
  <img
    src="https://github.com/raycast/extensions/raw/09173643b164442e34ce743b45e270a503c04a20/extensions/bitbucket//assets/bitbucket-logo.png"
    width="50"
  />

  <h1>
    Bitbucket
  </h1>

Raycast extension to search repositories, check pipelines status, open recent Pull Requests, and more to come.

  <p>
    <a href="https://www.raycast.com/francois/bitbucket">
      <img src="https://img.shields.io/badge/Raycast-store-red.svg"
        alt="Find this extension on the Raycast store"
      />
    </a>
    <a
      href="https://github.com/raycast/extensions/blob/master/LICENSE"
    >
      <img
        src="https://img.shields.io/badge/license-MIT-blue.svg"
        alt="raycast-extensions is released under the MIT license."
      />
    </a>
    <img
      src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg"
      alt="PRs welcome!"  
    />
    <a href="https://open.vscode.dev/organization/repository">
      <img
        src="https://open.vscode.dev/badges/open-in-vscode.svg"
        alt="Open in Visual Studio Code"
      />
    </a>
  </p>
</div>

![showcase](https://github.com/raycast/extensions/raw/09173643b164442e34ce743b45e270a503c04a20/extensions/bitbucket//assets/showcase.gif)

#### Features

- Quick access to your repositories
- Search your recent pipelines and see their status
- See your recent open pull requests

#### Getting started

- Go to to your Bitbucket Cloud profile, [under App Passwords](https://bitbucket.org/account/settings/app-passwords/)
- Click on `Create App Password`
- Give your App password a name e.g. `Raycast`, and select all the read options you need (Account, projects, repositories, Pull Requests, Pipelines)
- Store in a secure location the given App Password
- Start a bitbucket command and fill the required fields:
  - Workspace: You can see your workspaces [here](https://bitbucket.org/account/workspaces/), and use the slug. You can find it in the URL of your workspace: `https://bitbucket.org/{organization}/`
  - Account Name: You can find it [here](https://bitbucket.org/account/settings/) under `Bitbucket profile settings > Username`
  - App Password

Now you should be able to run Bitbucket commands with Raycast 🚀.

#### Roadmap

- [x] Use the Bitbucket Client NPM package instead of hardcoding the API
- [x] Show commit name in pipelines title
- [x] Addd pagination navigation to pipelines
- [ ] Dashboard with overview of differents queries (PRs, pipelines, etc)
- [ ] Extend pipelines capabilities to see logs & rerun a failed/stopped one
- [ ] Test performances with high number of repositories (only tested with 38 until now). And if bad performances, check:
  - [ ] Add pagination navigation to repositories
  - [ ] Load all repos in background and keep a cache of all of them (as repositories are quite static resources)
  - [ ] Only keep the field needed, to reduce JSON answer size

---

_Extension built & tested for Bitbucket Cloud_

Bitbucket API resource: https://developer.atlassian.com/cloud/bitbucket/rest/intro/

Bitbucket Client API resource: https://bitbucketjs.netlify.app/