Gitkraken

🚀 GitKraken CLI

gk はコマンドラインで利用できる GitKraken です。主な機能は「Work Items」に重点を置いています。Work Items は、取り組んでいる機能や課題と考えることができます。これにより、複数のリポジトリを同時に扱い、モノレポで作業する場合と同じ UX を実現できます。また、AI を活用した高品質なコミットメッセージの生成とプルリクエストの生成にも対応しています。さらに、Git や課題管理・Git ホスティングプロバイダーを使った作業を効率化する MCP サーバーも提供しています。

GitKraken CLI は macOS、Windows、Unix システムで利用できます。

目次

• MCP サーバー
• ドキュメント
• ワークフロー
• git コマンドのパススルー
• インストール
• トラブルシューティング
• サポート

MCP サーバー

GitKraken MCP サーバーは、強力で使いやすいローカル MCP サーバーです。Git、GitHub、Jira の MCP アクションをラップし、GitKraken の API や機能を利用する LLM 向けのツールも提供します。利用する AI アプリケーションに応じた具体的なインストール手順は、ヘルプセンターをご覧ください。

MCP サーバーについて詳しく知りたい場合は、紹介ブログ記事をご覧ください。

ドキュメント

CLI の使い方を調べるには、gk help が最適です。以下のワークフローもご覧ください。

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

単一のリポジトリでの使い方に慣れたら、新しい Work Item に複数のリポジトリを追加するだけで、複数のリポジトリを対象に Work Item を作成し、コミットや 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

gk は、次のコマンドで Homebrew からインストールできます。

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"

対応するパッケージ（.deb、.rpm）を[ダウンロード][releases page]して、次のコマンドでインストールすることもできます。

sudo apt install ./gk.deb

または

sudo rpm -i ./gk.rpm

---

Windows

gk は、次のコマンドで [Winget][winget] からインストールできます。

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 を実行し、「このまま開く」をクリックして続行します。