A extension that adds shortcut.com integration with VSCode, the purpose of this extension is to use all the great features of Shortcut without ever needing to leave the code editor. This means developers can spend more time coding, and less time moving/maintaining stories.
To use this extension you will need to provide a shortcut.com api key, you can generate one here https://app.shortcut.io/settings/account/api-tokens
This api key is stored locally in VSCode and is never shared with the outside world.
| Command | Description |
|---|---|
| Set Base Branch | Set's the default base branch, when new features branches are created/merged, they will use the default branch as the base |
| Create Story | Creates a brand new story, this will ask for the various story details |
| Get Stories | Get's all stories currently assigned to you (separated by workflow) |
| Search Stories | Searches all stories in shortcut.com, this supports all the search operators used in the main shortcut app. View the full list here |
| Create Commit | Pushes a new commit to the feature branch, and automatically creates the feature branch on remote |
| Create Pull Request | Opens the "create pull request" page on github, automatically selects the current feature branch and prefills the title and description. Note: This will not automatically open the PR this just saves you filling in some of the info yourself |
Workplace slug
This is the slug of the workplace you are working in, this can be found in the url of the shortcut.com website, for example if your url is https://app.shortcut.com/your-workplace-slug then your workplace slug is your-workplace-slug, this is used when opening stories in the browser.
Branch Format
This option enables you to change the default branch format when creating new branch, there are a couple of variable that can be added to the branch name which will automatically be replaced with the corresponding data in shortcut, these are the values that are currently supported:
[story_id]= sh1234[story_type]= feature[owner_username]= daniel[story_name]= example-story-name
Here is an example branch format:
[story_type]/[story_id]/[story_name]
To work on the extension locally, open this proejct in VSCode and press F5. This will open up a new instance of VSCode with the extension loaded.
Install act and run the following command
act -P ubuntu-latest=node:16 --reuse