gitkraken/gk-cli

gk is GitKraken on the command line. The core functionality is focused on "Work Items" which can be thought of as the feature or issue you are trying to tackle. This allows you to work with multiple repos at once and get the same UX as if you were in a monorepo. We also provide robust AI-powered commit messages and Pull Request generation. It also provides an MCP server that streamlines working with git and your Issue and git hosting providers.
GitKraken CLI is available on macOS, Windows, and Unix systems.
Table of Contents
- MCP Server
- Documentation
- Workflows
- git Command Passthrough
- Installation
- Troubleshooting
- Support
MCP Server
The GitKraken MCP server is a local MCP server that is powerful and easy to use. It wraps git, GitHub, Jira MCP actions as well as provides tools to LLMs that work with GitKraken APIs and functionality. You can find specific installation instructions based on your chosen AI application in the Help Center.
If you want to read more about the MCP server, you can check out the introduction blog post
Documentation
gk help is going to be your best source for exploring the CLI. But also see the workflows below.
Workflows
Start with a single repo. You can add more later.
In general, your process will look like this:
Once you have familiarized yourself with using a single repo, try out creating work items and generating commits and PRs for multiple repos at a time by just adding multiple repos to a new Work Item.
git Command Passthrough
You can also use gk to pass through any git command. eg:
Installation
macOS
gk is available from Homebrew with the following command:
Homebrew:
Or download it from the releases page and add it to your binaries folder:
---
Unix / Ubuntu
gk is available as a downloadable binary from the releases page. Once you have it, add it to your binaries folder:
Or create a new directory, move the binary and add it to $PATH:
You can also [download][releases page] your corresponding package (.deb, .rpm) and install it with:
or
---
Windows
gk is available from [Winget][winget] with the following command:
⚙️ Configuration
Nerd Fonts
The 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.
Troubleshooting
gk login freezes after authenticating in browser
This problem is due to the browser. Currently we know that Safari and Brave do not allow to respond to localhost through port 1314. To fix this, change your default browser or copy the URL before the redirect and open it in another browser.