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 wi
Add this skill
npx mdskills install gitkraken/gk-cliComprehensive git workflow CLI with multi-repo support, AI-powered commits/PRs, and MCP server integration
1# 🚀 GitKraken CLI23`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.45GitKraken CLI is available on macOS, Windows, and Unix systems.6789## Table of Contents1011- [MCP Server](#mcp-server)12- [Documentation](#documentation)13- [Workflows](#workflows)14- [`git` Command Passthrough](#git-command-passthrough)15- [Installation](#installation)16- [Troubleshooting](#troubleshooting)17- [Support](#support)1819## MCP Server2021The 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](https://help.gitkraken.com/cli/gk-cli-mcp/).2223If you want to read more about the MCP server, you can check out the [introduction blog post](https://www.gitkraken.com/blog/introducing-gitkraken-mcp)2425## Documentation2627`gk help` is going to be your best source for exploring the CLI. But also see the [workflows](#workflows) below.2829```bash30Welcome to GitKraken CLI, a premium CLI experience for managing multiple repositories with familiar GIT CLI commands3132Usage:33 gk [flags]34 gk [command]3536AUTHENTICATING37 auth Authenticate with the GitKraken platform38 provider Add or remove provider tokens3940CORE COMMANDS41 graph Display commit graph in current repository42 issue Manage your issues43 organization Manage your Gitkraken organizations44 work Interact with your work.45 workspace Interact with your workspaces. Alias: 'ws'4647Additional Commands:48 help Help about any command49 setup Display information about your current system configuration50 version Print the version number of GK CLI5152Flags:53 -h, --help help for gk5455Use "gk [command] --help" for more information about a command.56```5758## Workflows5960Start with a single repo. You can add more later.6162In general, your process will look like this:6364```bash6566# Authenticate67gk auth login6869# Navigate to a git repo directory on your filesystem70cd ./path/to/repo7172# Then create a Work Item and the current directory73# will be automatically added to the Work Item74gk work create "My new work item"7576# Edit files...77# ...7879# Commit your changes using AI80gk work commit --ai8182# Push your changes83gk work push8485# Create a Pull Request86gk work pr create --ai8788```8990Once 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.9192```bash93# Add a repo to the current work item94gk work add ./path/to/repo # path could be as simple as "." if you are in the directory already95```9697## `git` Command Passthrough9899You can also use `gk` to pass through any `git` command. eg:100101```bash102gk status103gk remote -v104# etc105```106107## Installation108109### macOS110111`gk` is available from [Homebrew](https://formulae.brew.sh/cask/gitkraken-cli) with the following command:112113Homebrew:114115```bash116brew install gitkraken-cli117```118119Or download it from the [releases page](https://github.com/gitkraken/gk-cli/releases) and add it to your binaries folder:120121```bash122mv ~/Downloads/gk /usr/local/bin/gk123```124125---126127### Unix / Ubuntu128129[](https://snapcraft.io/gitkraken-cli)130131`gk` is available as a downloadable binary from the [releases page](https://github.com/gitkraken/gk-cli/releases). Once you have it, add it to your binaries folder:132133```bash134mv ~/Downloads/gk /usr/local/bin/gk135```136137Or create a new directory, move the binary and add it to $PATH:138139```bash140mkdir "$HOME/cli"141mv ~/Downloads/gk "$HOME/cli"142export PATH="$HOME/gk:$PATH"143```144145You can also [download][releases page] your corresponding package (`.deb`, `.rpm`) and install it with:146147```bash148sudo apt install ./gk.deb149```150151or152153```bash154sudo rpm -i ./gk.rpm155```156157---158159### Windows160161`gk` is available from [Winget][winget] with the following command:162163```bash164winget install gitkraken.cli165```166167## ⚙️ Configuration168169### Nerd Fonts170171The 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.172173## Troubleshooting174175### `gk login` freezes after authenticating in browser176177This 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.178179### gk from Oh-My-Zsh180181Oh-My-Zsh has `gitk` aliased as `gk` and that can create some problems. To fix this, type in your terminal:182183```184unalias gk185```186187### Manual macOS Installation188189If you install the CLI manually from the releases page on macOS, you will likely run into a security error that looks like this:190191192193To fix this, go to Settings > Security & Privacy > General and click "Allow Anyway".194195196197Try running `gk setup` again and then click "Open Anyway" to continue.198199200
Full transparency — inspect the skill content before installing.