GitKraken CLI

Welcome to the GitKraken CLI — an AI-powered, premium developer experience that enhances Git workflows across any repository.

GitKraken CLI is available on macOS, Windows and Unix systems.

Documentation

Check out the installation instructions and examples below. For command usage see the docs.

Installation

macOS

gk is available from Homebrew with the following command:

brew install gitkraken-cli

Downloadable Binary

Or download it from the releases page and add it to your binaries folder:

mv ~/Downloads/gk /usr/local/bin/gk

Unix / Ubuntu

Snap

gk is available on Snap with the following command:

sudo snap install gitkraken-cli

Downloadable Binary

gk is available as a downloadable binary from the releases page. Once you have it, add it to your binaries folder:

mv ~/Downloads/gk /usr/local/bin/gk

Or create a new directory, move the binary and add it to $PATH:

mkdir "$HOME/cli"
mv ~/Downloads/gk "$HOME/cli"
export PATH="$HOME/gk:$PATH"

You can also download your corresponding package (.deb, .rpm) and install it with:

sudo apt install ./gk.deb

or

sudo rpm -i ./gk.rpm

Windows

gk is available from Winget with the following command:

winget install gitkraken.cli

Downloadable Binary

Download the binary from the releases page and place the gk.exe in a desired folder. Then edit your environment variables to add it to your PATH.

1. In Search, search for Environment Variables.
2. Click on the Edit the system environment variables result.
3. In the modal, click on the Environment Variables… button.
4. In the System Variables section, scroll until you find the PATH variable. Click on it.
   • If it doesn’t exist, create a variable with the name PATH.
5. Add the path to the gk binary at the end.

Troubleshooting

gk from Oh-My-Zsh

Oh-My-Zsh has gitk aliased as gk and that can create some problems. To fix this, type in your terminal:

unalias gk

Get Started with GitKraken CLI

GitKraken CLI does not require login to your GitKraken account, and most features are available immediately. However, to access advanced functionalities such as AI Commit and PR generation, cloud workspace management, and integration syncing, follow the steps below to enable these features.

To unlock the full potential of GitKraken CLI login to your account using the gk auth login command. This will open a login in your default browser.

Set Your GitKraken Organization

Once logged in, verify that you are in the correct GitKraken Organization by running: gk organization list.

To match your plan with the correct organization, set your default organization using: gk organization set <ORG_NAME>. This step is important for unlocking AI features.

Synchronize Your Integrations

Once logged in and your organization is set, you can synchronize your integrations from gitkraken.dev by running gk provider list --sync.

To manually connect to a provider, use: gk provider add.

For a full list of strings please see gk provider add --help.

GitKraken CLI currently supports GitHub, GitLab and Jira.

Load Your Repositories

Quickly load your repositories by opening your GitKraken workspace.

First, list your available workspaces: gk workspace list

Then, set your desired workspace: gk workspace set <NAME>

To clone a repository within the workspace, use: gk ws clone <name> <root-path>