Git Shortcuts Doctor is now a Git workflow assistant for VS Code, not just a shortcut pack.
It combines:
- easy keyboard shortcuts
- workflow-based actions
- PR-focused helpers
- a conflict recovery hub
- smart Git Doctor suggestions
All shortcuts use one pattern:
- Windows/Linux:
Ctrl+Alt+G - macOS:
Cmd+Alt+G
After that, press one more key for the action you want.
Easy examples
Ctrl+Alt+G Sfor statusCtrl+Alt+G Cfor commitCtrl+Alt+G Pfor pushCtrl+Alt+G Wto start a feature branchCtrl+Alt+G Jto start a PR branch frommainCtrl+Alt+G Ito sync your branch with the PR targetCtrl+Alt+G Vto check PR readinessCtrl+Alt+G Yto sync your branchCtrl+Alt+G Qto open Conflict CenterCtrl+Alt+G 1to accept current conflict changeCtrl+Alt+G 2to accept incoming conflict changeCtrl+Alt+G 3to accept both changesCtrl+Alt+G Hto run Git Doctor
You can also click the status bar button Git Keys to open a shortcut guide and action picker.
This project now includes the most common Git commands directly, and also a custom Git runner for commands not mapped to a built-in shortcut yet.
What makes it different
Start Feature: creates a new working branch quicklyStart PR Branch: creates a working branch frommain,develop, or another target branchSync With Target Branch: updates your current branch from the PR target branchCheck PR Readiness: checks conflicts, upstream, clean working tree, and commit difference before PRPrepare PR: builds a suggested PR title and body from your branch and commitsCreate PR: opens or creates a PR/MR for GitHub or GitLabSync Branch: lets you choose safe pull or pull with rebaseSave Work Quickly: helps you commit, stash, or stage current fileUndo Last Mistake: gives safe recovery actionsConflict Center: shows conflicted files and recovery commands in one placeGit Doctor: detects problems and suggests the next action directly
Included commands
Start FeatureStart PR BranchSync With Target BranchCheck PR ReadinessPrepare PRCreate PRSync BranchSave Work QuicklyUndo Last MistakeConflict CenterGit StatusFetch AllPull LatestPull RebaseAdd AllAdd Current FileCommitCommit AmendPushPush Force With LeaseCreate BranchCheckout BranchMerge BranchStash PushStash PopAbort MergeAbort RebaseAccept Current ChangeAccept Incoming ChangeAccept Both ChangesNext ConflictPrevious ConflictDiagnose Git StateRun Custom Git Command
Shortcut keys
Ctrl+Alt+G D: open dashboardCtrl+Alt+G W: start featureCtrl+Alt+G J: start PR branchCtrl+Alt+G I: sync with target branchCtrl+Alt+G V: check PR readinessCtrl+Alt+G Shift+V: prepare PRCtrl+Alt+G Shift+J: create PRCtrl+Alt+G Y: sync branchCtrl+Alt+G K: save work quicklyCtrl+Alt+G Z: undo last mistakeCtrl+Alt+G Q: conflict centerCtrl+Alt+G S: statusCtrl+Alt+G F: fetch allCtrl+Alt+G U: pull latestCtrl+Alt+G L: pull with rebaseCtrl+Alt+G A: add allCtrl+Alt+G .: add current fileCtrl+Alt+G C: commitCtrl+Alt+G Shift+C: commit amendCtrl+Alt+G P: pushCtrl+Alt+G Shift+P: push force with leaseCtrl+Alt+G N: create branchCtrl+Alt+G B: checkout branchCtrl+Alt+G E: merge branch into current branchCtrl+Alt+G T: stash pushCtrl+Alt+G O: stash popCtrl+Alt+G M: abort mergeCtrl+Alt+G R: abort rebaseCtrl+Alt+G 1: accept current conflictCtrl+Alt+G 2: accept incoming conflictCtrl+Alt+G 3: accept both conflictsCtrl+Alt+G [: previous conflictCtrl+Alt+G ]: next conflictCtrl+Alt+G H: Git DoctorCtrl+Alt+G X: run any custom Git command
Examples
Ctrl+Alt+G J: create a new PR branch frommainCtrl+Alt+G I: rebase or merge your branch withmainbefore updating the PRCtrl+Alt+G V: check if your branch is clean and ready for PRCtrl+Alt+G Shift+V: generate a suggested PR title and descriptionCtrl+Alt+G Shift+J: open or create the PR in GitHub or GitLabCtrl+Alt+G B: checkout a different branchCtrl+Alt+G U: pull latest changes from remoteCtrl+Alt+G E: merge another branch into your current branchCtrl+Alt+G Y: fetch and choose whether to pull or rebaseCtrl+Alt+G Q: open the list of conflicted files and recovery actionsCtrl+Alt+G Z: undo a bad last commit without losing changesCtrl+Alt+G X, then typegit cherry-pick abc1234Ctrl+Alt+G X, then typegit reset HEAD~1
PR support
This extension helps with Git work around pull requests:
- create the branch you want to use for the PR
- sync your current branch with
main,develop, or another target branch - check if your branch is behind target, has conflicts, or has uncommitted changes
- see which commits would be included in the PR
- generate a suggested PR title and body from commit history
- create a GitHub PR or GitLab MR from inside VS Code
PR creation works like this:
- if the repo remote is GitHub and
ghis installed, it can rungh pr create - if the repo remote is GitLab and
glabis installed, it can runglab mr create - otherwise it opens the browser on the correct GitHub or GitLab PR/MR creation page
Current platform support:
- GitHub
- GitLab
Bitbucket direct PR creation is not implemented yet.
Settings
You can configure the extension from VS Code Settings:
gitShortcutsDoctor.defaultTargetBranchExample:mainordevelopgitShortcutsDoctor.preferredPrModeOptions:auto,cli,browsergitShortcutsDoctor.prTitleTemplatePlaceholders:{branch},{target},{firstCommit},{commitCount}gitShortcutsDoctor.prBodyTemplatePlaceholders:{branch},{target},{firstCommit},{commitCount},{commitBullets},{workingTreeClean}
Example templates:
- PR title:
{branch} -> {target}: {firstCommit} - PR body:
Target branch: {target}``Included commits{commitBullets}
Project structure
package.json: extension manifest, commands, and keybindingssrc/extension.js: command handlers and Git integration
Run locally
- Open this project in VS Code.
- Press
F5to launch the Extension Development Host. - In the new window, open a Git repository folder.
- Run
Git Shortcuts Doctor: Open Dashboardfrom the command palette.
Next improvements
- add more Git commands in grouped menus
- detect more Git error messages
- show branch comparison details
- add automated tests for command handlers