Skip to content

Latest commit

 

History

History
179 lines (129 loc) · 10.7 KB

README.md

File metadata and controls

179 lines (129 loc) · 10.7 KB

Gitpod Logo
Gitpod Raycast Extension

Powered by The Gitpod Community 💛

Gitpod ready-to-code Werft.dev - Gitpod CI Discord

Community Raycast Extension for Gitpod

The Community Raycast Extension is an extension made for the Raycast App in MacOS, which promises to integrate the best features of Gitpod with your operating system by means of Raycast.

The Community Raycast Extension, made by Gitpod Heroes Henit Chobisa and M Palanikannan serves the soul aim of making the accessibility of Gitpod Blazingly Faster than Local Development by providing extensive features to Open any GitHub context with Gitpod or Managing your Workspaces just with a click on your menubar, the extension has got you covered 😉

The.Gitpod.Raycast.Extension.Henit.X.Palani.mp4

Let's get it on your Mac!

  1. Install Raycast to get started if you haven't by simply clicking on this button!

  1. Navigate to the Raycast Store to Download the Gitpod extension GithubLogin
  2. Authenticate with GitHub GithubLogin
  3. For directly Creating, Starting, Stopping and Viewing the Gitpod workspaces from within the Raycast extension, you'll need a Gitpod Access Token which is currently in beta and available for limited users. GithubLogin
  • If you have a Gitpod Access token, navigate to Raycast Command settings for the Gitpod extension by using Cmd + , and set the Access token there. GithubLogin
  • If you dont have the Access token, you can still Open any GitHub context from the extension in Gitpod (you'll be directed to your browser in this case)
  1. Setup your default organization for Creating new workspaces in the Manage Workspaces Window. GithubLogin

Command Descriptions

Manage Workspaces

Manage Workspaces Command is responsible for managing your workspaces from Gitpod Dashboard, you can stop or start your existing workspaces there or create empty workspaces

Open Contexts from Github

Open Contexts command takes the responsibility off your hands to manually browse through GitHub to open workspaces from any context url, no matter if it's a PR, Issue, Branch or the Repository itself. Along with that you can PIN contexts for later use/quick access or can view your Issues/PR descriptions right in the extension!

Menubar Workspaces

Menubar Workspaces is the command that gets the extension so near to achieving it's goal of making Gitpod Faster than local, with it's function to start workspaces and opening it into your favourite IDE in just a click!

Table of Contents

  1. Key Features
  2. Feedback
  3. Instructions for Beta Testers

Key Features

Navigating Contexts

With the Open Context from Github Command, it's incredibly easy to navigate contexts such as Repositories, Branches, Pull Requests and Issues.

Browsing and Filtering

  • You can browse Repositories and also any context URL inside of the repository i.e. it's branches, PR or Issues Browsing Contexts Browsing Ctx
  • Along with that we make sure that your browsing experience should be super smooth with the help of filtering You can filter and search further using the following tags - /b for branch - /p for PRs - /i for Issues - /me for anything and everything related to - eg. /me /p would refer to your Pull Requests in a particular repository! ContextView

Displaying Contexts

Say you're a product manager or an OSS maintainer, you're tired of opening GitHub again and again browsing through issues/prs to find the right one to solve/review, we got you covered by providing context previews, so that you can have a glimpse on Issues/PRs on the fly. Displaying Context Displaying Context

Pinning Contexts for Faster Access

We pin every context that you open with Gitpod, for faster access and if you wish to manually add any context to your Recents/Pinned list, you can achieve by a single command cmd + R and bingo! Pinning Context Pinning Context Pinning Context

Opening Contexts with Github

If Context Display is not enough and you need a deep dive in conversation or add any labels, you can open contexts directly in Github with a single command cmd + RETURN Opening Context in Github

Managing Workspaces

Starting Workspaces (Requires Gitpod Access Token)

Using the Managing Workspace Command, you can Start and launch your workspaces in your preferrred IDE. The extension shows you all the stages of your workspaces, Running, Progressing and Stopped.

Screen.Recording.2023-08-08.at.1.37.37.PM.mov
Screen.Recording.2023-08-08.at.1.38.15.PM.mov

Wait!! There is more, with Menubar Workspace Menubar command, to do this which is the key feature for Gitpod Accessibility faster than local.

Screen.Recording.2023-08-08.at.1.32.10.PM.mov

Stopping Workspaces (Requires Gitpod Access Token)

You can use a simple command Cmd + s, on the running workspaces and you can see them stopping in real time, just like magic ✨

Screen.Recording.2023-08-08.at.1.34.51.PM.mov

Selecting Default Editor to Open

You can also select your favourite editor for opening your workspaces, just go to Command Preferences of the Raycast extension with cmd + , and change the default editor, currently the extension supports VSCode Browser, VSCode Desktop and SSH (in your default ssh client with which you can even use VIM, checkout axonasif/dotsh.

Changing Editor

Creating New Workspaces

Currently the extension supports two types of creating workspaces,

  1. Creating Workspaces from Context
  2. Creating Empty Workspaces
  3. Creating Workspaces from Context Opened in Browser

Creating Workspaces from Context

( Requires Gitpod Access token) You can browse through contexts in the Open Context from Github Command and can create a workspace directly from the there just by using cmd + g, g for Gitpod.

Screen.Recording.2023-08-08.at.1.45.03.PM.mov

Along with that for creating workspaces, you can also add your configuration such as workspace size, just by using cmd + e, where you can select your editor and workspace size for a particular context from which a workspace is to be created. Configure Workspace Configure Tab

Creating Empty Workspaces

For creating empty workspaces on the go, say for some quick experimentation, you can use both the Open Context Command or Menubar Command

Screen.Recording.2023-08-08.at.1.57.46.PM.mov
Screen.Recording.2023-08-08.at.1.57.08.PM.mov

Creating Workspaces from Context Opened in Browser

Let's say if you're looking at a github pullrequest / issue / repository / branch in your browser ( chrome / safari ), you can just click on the menubar icon and you can see the context you were looking at in the create workspaces section. Just click on that and a new workspace will be created for you, just with a click!

WhatsApp.Video.2023-09-21.at.14.45.05.mp4

Feedback

At last, we would love 🧡 to hear from you to improve the extension, hence we also put a command called feedback, so that you can report any issue in the extension or you can make a feature extension.

Instructions for Beta Testers

After Joining the Beta Tester Organization by using the link provided to you by the maintainer or a previous beta tester.

  • Navigate to Store
  • Change the Store Setting from Public to Gitpod (Beta)
  • Install the Beta Extension from the Gitpod Extension Store.