Gk Cli

🚀 GitKraken CLI

gk 是命令行版本的 GitKraken。其核心功能聚焦於“工作項”，你可以將其視為你正在處理的功能或問題。這使你能夠同時處理多個倉庫，並獲得與在單倉庫中工作相同的用戶體驗。我們還提供強大的由人工智能驅動的提交消息和拉取請求生成功能。此外，它還提供了一個 MCP 服務器，可簡化與 Git 以及你的問題和代碼託管平臺的協作。

GitKraken CLI 可在 macOS、Windows 和 Unix 系統上使用。

📚 目錄

• MCP 服務器
• 文檔說明
• 工作流程
• 安裝步驟
• 故障排除
• 技術支持

🛠️ MCP 服務器

GitKraken MCP 服務器是一個強大且易於使用的本地 MCP 服務器。它封裝了 Git、GitHub、Jira MCP 操作，併為使用 GitKraken API 和功能的大語言模型提供工具。你可以在 幫助中心 中找到根據你選擇的人工智能應用的具體安裝說明。

如果你想了解更多關於 MCP 服務器的信息，可以查看 介紹博客文章。

📖 文檔說明

gk help 是探索該 CLI 的最佳資源。同時也可查看下面的 工作流程。

歡迎使用 GitKraken CLI，這是一款高級 CLI 工具，可使用熟悉的 GIT CLI 命令管理多個倉庫

用法:
  gk [標誌]
  gk [命令]

認證相關命令
  auth         使用 GitKraken 平臺進行認證
  provider     添加或移除平臺令牌

核心命令
  graph        顯示當前倉庫的提交圖
  issue        管理你的問題
  organization 管理你的 Gitkraken 組織
  work         與你的工作進行交互
  workspace    與你的工作區進行交互。別名: 'ws'

其他命令:
  help         獲取任何命令的幫助信息
  setup        顯示當前系統配置信息
  version      打印 GK CLI 的版本號

標誌:
  -h, --help   獲取 gk 的幫助信息

使用 "gk [命令] --help" 可獲取有關命令的更多信息。

🔨 工作流程

從單個倉庫開始使用，你可以在之後添加更多倉庫。

一般來說，你的操作流程如下：

# 進行認證
gk auth login

# 導航到文件系統中的 Git 倉庫目錄
cd ./path/to/repo

# 然後創建一個工作項，當前目錄將自動添加到該工作項中
gk work create "My new work item"

# 編輯文件...
# ...

# 使用人工智能提交更改
gk work commit --ai

# 推送更改
gk work push

# 創建拉取請求
gk work pr create --ai

一旦你熟悉了使用單個倉庫，就可以嘗試通過將多個倉庫添加到一個新的工作項中，同時為多個倉庫創建工作項、生成提交和拉取請求。

# 將一個倉庫添加到當前工作項中
gk work add ./path/to/repo # 如果你已經在該目錄中，路徑可以簡單地寫成 "."

🪄 git 命令透傳

你也可以使用 gk 來透傳任何 git 命令。例如：

gk status
gk remote -v
# 等等

📦 安裝步驟

macOS

可以使用以下命令通過 Homebrew 安裝 gk：

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"

你也可以 下載 相應的軟件包（.deb、.rpm）並使用以下命令進行安裝：

sudo apt install ./gk.deb

或者

sudo rpm -i ./gk.rpm

Windows

可以使用以下命令通過 Winget 安裝 gk：

winget install gitkraken.cli

⚙️ 配置說明

奈爾德字體

GitKraken CLI 支持使用奈爾德字體來為某些命令顯示圖標。為確保圖標正確渲染，請從 https://www.nerdfonts.com/ 獲取並安裝奈爾德字體。安裝完成後，將所選的奈爾德字體設置為終端的默認字體。

🐞 故障排除

gk login 在瀏覽器認證後凍結

此問題是由瀏覽器導致的。目前我們知道 Safari 和 Brave 不允許通過端口 1314 響應本地主機。要解決此問題，請更改默認瀏覽器，或者在重定向之前複製 URL 並在另一個瀏覽器中打開。

Oh-My-Zsh 中的 gk 問題

Oh-My-Zsh 將 gitk 別名為 gk，這可能會導致一些問題。要解決此問題，請在終端中輸入：

unalias gk

macOS 手動安裝問題

如果你在 macOS 上從發佈頁面手動安裝 CLI，可能會遇到如下安全錯誤：

要解決此問題，請轉到“設置”>“安全與隱私”>“通用”，然後點擊“仍要允許”。

再次嘗試運行 gk setup，然後點擊“仍要打開”以繼續。

📞 技術支持

如果你在使用過程中遇到任何問題或需要進一步的幫助，請隨時聯繫我們的技術支持團隊。