{"id":14155400,"url":"https://github.com/gitkraken/gh-gk","last_synced_at":"2025-07-22T11:40:21.333Z","repository":{"id":212375849,"uuid":"731351273","full_name":"gitkraken/gh-gk","owner":"gitkraken","description":"Master multi-repo workflows, synchronize on PRs \u0026 Issues, and integrate seamlessly with GitKraken Client \u0026 GitLens for VS Code for instant Git visualization.","archived":false,"fork":false,"pushed_at":"2024-11-04T10:47:55.000Z","size":15,"stargazers_count":69,"open_issues_count":2,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-10T04:51:59.713Z","etag":null,"topics":["gh-extension"],"latest_commit_sha":null,"homepage":"https://www.gitkraken.com/cli","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitkraken.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-13T22:18:47.000Z","updated_at":"2025-02-12T22:32:30.000Z","dependencies_parsed_at":"2024-08-17T08:16:45.141Z","dependency_job_id":null,"html_url":"https://github.com/gitkraken/gh-gk","commit_stats":null,"previous_names":["gitkraken/gh-gk"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitkraken%2Fgh-gk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitkraken%2Fgh-gk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitkraken%2Fgh-gk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitkraken%2Fgh-gk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitkraken","download_url":"https://codeload.github.com/gitkraken/gh-gk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243188203,"owners_count":20250453,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gh-extension"],"created_at":"2024-08-17T08:03:01.311Z","updated_at":"2025-03-12T08:45:25.963Z","avatar_url":"https://github.com/gitkraken.png","language":null,"funding_links":[],"categories":["🧩 Categories","gh-extension","Others"],"sub_categories":["Repository Management"],"readme":"\n# 🚀 GitKraken CLI Extension\n\n`gk` is the GitKraken command line extension to GitHub CLI (`gh`).  It makes working across multiple repos easier with Workspaces, provides access to pull requests and issues from multiple services (GitHub, GitLab, Bitbucket, etc.), and seamlessly connects with [GitKraken Client](https://www.gitkraken.com/git-client) and [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) in VS Code to visualize `git` information when you need it.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/86774052/225326381-aaea81a3-9f19-4170-9e0b-2f42fac8edda.png\" style=\"margin: 0 auto\" /\u003e\n\u003c/p\u003e\n\nGitKraken CLI is available on macOS, Windows and Unix systems.\n\n## 📚 Documentation\n\nCheck out the [installation instructions](#installation) and [examples](#examples) below. For command usage [see the docs][documentation].\n\n## Installation\n\n```sh\n gh extension install gitkraken/gh-gk\n```\n\n\n## Updating extension\n\n```sh\ngh extension upgrade gitkraken/gh-gk\n```\n\n## Uninstalling extension\n\n```sh\ngh extension remove gitkraken/gh-gk\n```\n\n## ⚙️ Configuration\n### Nerd Fonts\nThe GitKraken CLI supports Nerd Fonts to display icons for some commands. To ensure correct icon rendering, please obtain and install a Nerd Font available at https://www.nerdfonts.com/. After installation, set the selected Nerd Font as the default font for your terminal.\n\n## Examples\n### 🎯 Focus View\n```\ngh gk focus\n```\nGitKraken Focus View is a unified dashboard that consolidates PRs, Issues, and WIPs across all of the repositories in a [Cloud Workspace](#-create-workspaces-to-group-repos). You can view the details of any item and take action on your most important tasks.\n\n![gk-focus-screenshot](https://github.com/gitkraken/gh-gk/assets/115040794/ee364f95-8081-4f77-a8ce-f651e255d416)\n\n#### Pin items to keep them at the top of your list\nUse the shortcut \u003ckbd\u003ep\u003c/kbd\u003e to pin any PR or Issue to the top of the list. You can unpin an item by using the same shortcut on any pinned item.\n#### Snooze items to save them for later\nUse the shortcut \u003ckbd\u003es\u003c/kbd\u003e to snooze any PR or Issue, removing them from the list of items. You can view snoozed items by navigating to the `Snoozed` tab in the Focus View. You can unsnooze items and bring them back into your Focus View lists by using the same shortcut on any snoozed item.\n\n### 🤝 Create Workspaces to group repos\n```\ngh gk ws create\n```\nGitKraken workspaces associate groups of repos and set the context for helpful commands that can operate on, or get information for, multiple repos at once. There are two types of workspaces:\n##### Local\nLocal Workspaces exist only on your machine.\n##### Cloud\nCloud Workspaces are accessible on any machine, and can be connected to hosting and issue providers like GitHub and GitLab to get additional information about pull requests and issues. Share Cloud Workspaces with your team to improve onboarding with the ability to clone all repos at once. To enable this extra functionality, Cloud Workspaces require a free GitKraken account. We are continuing to evolve and improve GitKraken Workspaces and welcome any feedback.\n\n![Screenshot 2023-12-22 at 10 34 29 AM](https://github.com/gitkraken/gh-gk/assets/115040794/8786324d-cabe-425f-94aa-cdfab12b928a)\n\n#### Adding and locating repos\n```\ngh gk ws add-repo\n```\nThis will add a new repo to a workspace either by path or remote URL.\n```\ngh gk ws locate\n```\nIf you're accessing a Cloud Workspace for the first time, you might need to `locate` the local repos on your machine. Run this command in the directory where youre repos are located so `gk` knows where they are.\n```\ngh gk ws clone\n```\nYou can also `clone` all repos in a Workspace at once into a single directory. This is helpful for onboarding when your team works on multiple repos.\n\n### 🎬 Perform `git` actions on multiple repos at once\n```\ngh gk ws [action]\n```\nIn any workspace, you can perform `git` operations like `fetch`, `pull`, `push`, and `checkout` across all repos in the workspace.\n\n### 📋 Get pull requests and issues\n```\ngh gk provider add\n```\nBefore fetching pull requests and issues, ensure that you have the appropriate provider (GitHub, GitLab, etc.) connected. This will open a browser to authenticate.\n\n```\ngh gk pr list\n```\nWhen a Cloud Workspace has a provider connected, you can list all pull requests and issues for repos in the workspace, and view details for a specific one.\n\n![gh-gk-pr-list-screenshot](https://github.com/gitkraken/gh-gk/assets/115040794/4579ed18-8457-4834-a640-27797d4ec093)\n\n```\ngh gk pr view\n```\nReturns a list of all pull requests for all repos in a workspace. Type to search for a specific pull request and press `enter` to view details.\n\n![Screenshot 2023-12-22 at 10 22 30 AM](https://github.com/gitkraken/gh-gk/assets/115040794/bd1a79ee-fd79-444a-b910-c17ef14a973b)\n\n### 📈 Pull Request Insights\n```\ngh gk ws insights\n```\nSee the following metrics for all repositories in a Cloud Workspace. The default time period is 7 days, but can be increased to 14 days with any paid GitKraken license.\n- Average Cycle Time\n- Average Throughput\n- Merge Rate\n- Opened Pull Requests\n- Merged Pull Requests\n- Closed Pull Requests\n\n![gh-gk-insights-screenshot](https://github.com/gitkraken/gh-gk/assets/115040794/3d1eb72b-5e8d-4c2f-b1a7-de13714ceba4)\n\n\n### ✨ Visual Commit Graph\n```\ngh gk graph\n```\nOpen a visual graph of the repo in your current directory in either [GitKraken Client](https://www.gitkraken.com/git-client) or [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) in VS Code.\n\nhttps://github.com/gitkraken/gh-gk/assets/115040794/9ac6bc82-3596-4544-b3c7-c6966cfd09fd\n\n[documentation]: https://gitkraken.github.io/gk-cli/\n[releases page]: https://github.com/gitkraken/gh-gk/releases/latest\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitkraken%2Fgh-gk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitkraken%2Fgh-gk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitkraken%2Fgh-gk/lists"}