Gitkraken

🚀 GitKraken CLI

gk 是命令行版的 GitKraken。其核心功能围绕“工作项”展开，你可以将工作项理解为要处理的功能或问题。借助它，你可以同时使用多个仓库，并获得与在单体仓库中工作相同的体验。我们还提供强大的 AI 驱动提交消息和拉取请求生成功能。此外，它还提供 MCP 服务，可简化与 git 及问题跟踪和 git 托管服务提供商的协作。

GitKraken CLI 可用于 macOS、Windows 和 Unix 系统。

目录

• MCP 服务
• 文档
• 工作流
• git 命令透传
• 安装
• 故障排除
• 支持

MCP 服务

GitKraken MCP 服务是一个功能强大且易于使用的本地 MCP 服务。它封装了 git、GitHub 和 Jira 的 MCP 操作，还向大模型提供可与 GitKraken API 和功能配合使用的工具。你可以在帮助中心中找到适用于所选 AI 应用的具体安装说明。

如需了解更多 MCP 服务相关信息，请参阅介绍博客文章

文档

gk help 是了解 CLI 的最佳方式。你也可以参阅下文的工作流。

Welcome to GitKraken CLI, a premium CLI experience for managing multiple repositories with familiar GIT CLI commands

Usage:
  gk [flags]
  gk [command]

AUTHENTICATING
  auth         Authenticate with the GitKraken platform
  provider     Add or remove provider tokens

CORE COMMANDS
  graph        Display commit graph in current repository
  issue        Manage your issues
  organization Manage your Gitkraken organizations
  work         Interact with your work.
  workspace    Interact with your workspaces. Alias: 'ws'

Additional Commands:
  help         Help about any command
  setup        Display information about your current system configuration
  version      Print the version number of GK CLI

Flags:
  -h, --help   help for gk

Use "gk [command] --help" for more information about a command.

工作流

从单个仓库开始，之后可以添加更多仓库。

一般来说，你的工作流程如下：

# Authenticate
gk auth login

# Navigate to a git repo directory on your filesystem
cd ./path/to/repo

# Then create a Work Item and the current directory
# will be automatically added to the Work Item
gk work create "My new work item"

# Edit files...
# ...

# Commit your changes using AI
gk work commit --ai

# Push your changes
gk work push

# Create a Pull Request
gk work pr create --ai

熟悉如何使用单个仓库后，可以尝试创建工作项，并通过向新的工作项添加多个仓库，一次为多个仓库生成提交和 PR。

# Add a repo to the current work item
gk work add ./path/to/repo # path could be as simple as "." if you are in the directory already

git 命令透传

你也可以使用 gk 透传任意 git 命令。例如：

gk status
gk remote -v
# etc

安装

macOS

可通过以下命令使用 Homebrew 安装 gk：

Homebrew：

brew install gitkraken-cli

也可以从发布页面下载，并将其添加到二进制文件目录中：

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

---

Unix / Ubuntu

gk 可从发布页面下载为二进制文件。下载后，将其添加到二进制文件目录中：

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

或者新建一个目录，将二进制文件移入其中，并将该目录添加到 $PATH：

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

你也可以[下载][releases page]对应的软件包（.deb、.rpm），并使用以下命令安装：

sudo apt install ./gk.deb

或

sudo rpm -i ./gk.rpm

---

Windows

可通过以下命令使用 [Winget][winget] 安装 gk：

winget install gitkraken.cli

⚙️ 配置

Nerd Fonts

GitKraken CLI 支持 Nerd Fonts，可为部分命令显示图标。为确保图标正确显示，请从 https://www.nerdfonts.com/ 获取并安装 Nerd Font。安装后，将所选 Nerd Font 设为终端的默认字体。

故障排除

gk login 在浏览器中完成身份验证后卡住

此问题由浏览器导致。目前已知 Safari 和 Brave 不允许通过端口 1314 响应 localhost。要解决此问题，请更改默认浏览器，或在重定向前复制 URL，并在其他浏览器中打开。

Oh-My-Zsh 中的 gk

Oh-My-Zsh 将 gitk 设置了 gk 别名，这可能会导致一些问题。要解决此问题，请在终端中输入：

unalias gk

macOS 手动安装

如果你在 macOS 上从发布页面手动安装 CLI，很可能会遇到如下安全错误：

要解决此问题，请前往“设置”>“安全性与隐私”>“通用”，然后点击“仍要允许”。

再次运行 gk setup，然后点击“仍要打开”以继续。