GitTree デスクトップマニュアル

日常業務には GitTree を使用してください

GitTree は、macOS、Windows、および Linux 用のデスクトップ Git クライアントです。サインインすると、すべてのローカル Git タスク (オープン、クローン、コミット、ブランチ、マージ、リベース、スタッシュ、アンドゥ) が無料プランで実行されます。 GitTree Pro には、ホスティング統合、CI/CD 実行、AI 製図、AI アシスタント Nour が追加されます。

macOS に GitTree をインストールします

GitTree for Mac は、Apple シリコンおよび macOS 13 以降の Intel Mac 用の 1 つのユニバーサル アプリであり、Apple によって署名および公証されています。まず Git をインストールし、.dmg を開き、GitTree をアプリケーションにドラッグして起動します。

Windows に GitTree をインストールします

Windows の GitTree は、Windows 10 (22H2) および Windows 11 用の 64 ビット インストーラーです。まず Git for Windows をインストールし、Microsoft Store または直接 EXE を選択して、[スタート] メニューから GitTree を起動します。

Linux に GitTree をインストールします

Linux の GitTree は、Ubuntu 22.04 以降および Debian 12 以降では .deb として、またポータブルな AppImage として、両方とも 64 ビット x86_64 で提供されます。まず Git 2.39 以降をインストールしてから、apt を使用して .deb をインストールするか、AppImage を実行します。

Git を見つけてコミット ID を設定する

GitTree はコンピュータにインストールされている Git を実行しますが、Git をバンドルすることはありません。 Git 2.39 以降と、コミットの名前とメールアドレス (user.name と user.email) が必要です。コミットに初めて必要な場合は、これが要求されます。

GitTreeの周りを探す

リポジトリ タブには、タブ バー、ツールバー、サイドバー、コミット グラフ、インスペクター、ステータス バーの 6 つの部分があります。このページには、それぞれがどこにあるのか、そしてそこで何をするのかが示されています。

最初のコミットを作成する

コミットすると、ステージングした変更のスナップショットがその理由を示すメッセージとともに保存されます。 GitTree では、変更パネルにファイルをステージングし、概要を入力して Commit を押します。新しいコミットがグラフの上部に表示されます。

ローカル Git を無料で使用して Pro を理解する

GitTree のすべてのローカル Git 機能は、GitTree アカウントでサインインしているすべての人に無料で提供されます。 GitTree Pro には、ホスティング統合と AI ドラフト機能である Nour が追加されています。リクエストした場合にのみ開始される無料トライアルでそれらを試すことができます。

既存のリポジトリを開く

すでにコンピュータ上にある Git リポジトリのフォルダを選択すると、GitTree がコミット グラフ、分岐、変更を含む独自のタブで開きます。何もアップロードされません。リポジトリはコンピュータ上に残ります。

リポジトリのクローンを作成する

クローン作成により、GitHub、GitLab、Bitbucket、Azure DevOps、または任意の Git サーバーからリポジトリが履歴とともにコンピュータにコピーされます。 GitTree に URL を貼り付け、保存先を選択して Clone を押します。完了すると新しいタブで開きます。

リポジトリを作成する

初期化すると、git init と同じように、フォルダーが Git リポジトリに変わります。 GitTree では、フォルダと最初のブランチを選択し、オプションで .gitignore とライセンスを追加して、Initialize を押します。

最近のお気に入りのリポジトリを使用する

新しいタブには、Recent で開いたリポジトリと、Favourites でスターを付けたリポジトリがリストされます。タブで開くには、いずれかを選択します。リストはこのコンピュータ上に残ります。

ディスク上のリポジトリを検索する

Scan for Repositories… は、選択したフォルダーを調べて、フォルダーの深さ 3 つまでのすべての Git リポジトリを一覧表示します。あなたが選択するまでは何も開かれません。それらを開くことも、ワークスペースに追加することもできます。

リポジトリの信頼性を確認する

一部のリポジトリには、Git が動作するときにコンピュータ上でプログラムを実行する Git 設定またはフックが含まれています。それが起こる前に、GitTree は Trust this repository? を検出したものと正確に表示し、それを信頼するか、Restricted mode で開くことができるようにします。

ベアリポジトリを開く

ベア リポジトリには履歴がありますが、他のサーバー (git init --bare、git clone --bare) にプッシュするためにサーバーが保持しているような作業ファイルはありません。 GitTree はそれを開いてグラフ、分岐、タグを表示し、タブ bare をマークして、作業ファイルを必要とするアクションをオフにします。

リポジトリタブの管理

各リポジトリは、ウィンドウの上部にある独自のタブで開きます。タブには、コミットされていない変更や進行中のリベースなどのリポジトリの状態が表示され、キーボードからタブを切り替えることができます。

コミットグラフを読む

コミット グラフには、リポジトリの履歴が行として表示されます。行は新しいものから順に表示され、ブランチが開始する場所で分割され、ブランチがマージする場所で結合するレーンが含まれます。行のラベルは分岐とタグを示します。チェックマークは、現在いるブランチを示します。

コミットを見つける

グラフ内で Ctrl+F (Mac では ⌘F) を押し、コミット メッセージ、作成者、SHA、ブランチ、またはタグの一部を入力します。 GitTree は一致を強調表示し、一致の間を移動します。 Filter Graph は履歴自体を絞り込みます。

コミットを検査する

グラフ内のコミットを選択すると、右側のインスペクターに、メッセージ、完全な SHA、その親、誰が書いてコミットしたか、変更されたファイルなど、それに関するすべてが表示されます。ファイルを選択すると、その差分が表示されます。

グラフに焦点を当ててフィルタリングする

ビジーなリポジトリでは、Focus on Current Branch にはブランチ、そのアップストリーム、ベースのみが表示され、ベース以降のコミット数も表示されます。 Filter Graph… は、作成者のコミット、日付範囲、またはパスを保持します。フィルタリングによって履歴が削除されることはありません。 Clear Graph Filter はすべての行を戻します。

グラフの列をカスタマイズする

グラフには、デフォルトで分岐ラベル、レーン、メッセージが表示されます。 Graph columns メニューは、Author、Date、および SHA 列を追加し、コンパクトな行に切り替えます。すべての列のサイズを変更したり、サイドパネルを非表示にしたりできます。

コミットを比較し、選択内容に基づいて動作する

Ctrl (Mac の場合は ⌘) を押しながら 2 つのコミットを選択し、Compare These Two Commits を選択すると、異なるすべてのファイルが表示されます。いくつかのコミットを選択すると、SHA のコピー、チェリーピック、元に戻す、スカッシュ、パッチの作成などの独自のアクションがあります。

グラフのドラッグ アンド ドロップを使用する

ブランチ ラベルをグラフ内の別のブランチにドラッグすると、GitTree は 2 つでできることを提供します: Fast-forward、Merge、または Rebase。あなたが選択するまでは何も起こりません。通常の確認と取り消しが適用されます。

作業上の変更を確認する

Working Changes パネルは GitTree の git status です。最後のコミット以降に変更したすべてのファイルが Unstaged Files と Staged Files に分割されて一覧表示され、選択したファイルの差分が表示されます。

ファイル、ハンク、および選択された行をステージングする

コミットには、ステージングした内容のみが含まれます。 GitTree では、ファイル全体、ファイルの 1 つの部分、または差分で選択した行だけをステージングし、残りの編集内容は後でコミットするために作業フォルダーに残ります。

コミットメッセージを書いてコミットする

コミット フォームは、ステージングされたファイルの下にあります。Summary 行、オプションの Description、および共同作成者、サインオフ、フック、その後のプッシュ用の Commit Options です。 GitTree は、コミットする前によくあるメッセージの間違いを指摘します。

最後のコミットを修正する

修正すると、最後のコミットが、修正されたメッセージと現在ステージングしている変更を含む新しいコミット（git commit --amend など）に置き換えられます。 GitTree では、コミット フォームの Amend Previous Commit スイッチです。

変更を破棄し、追跡されていないファイルを削除します

破棄すると、ファイルは最後にコミットされた状態またはステージングされた状態（git restore など）に戻ります。クリーニングでは、Git が追跡しないファイル (git clean など) が削除されます。 GitTree は最初に回復スナップショットを保存するため、Undo はそれらを元に戻すことができます。

差分ビューを選択して使用する

GitTree 内のすべての差分は、Hunk、Inline、または Split として (並べて) 表示できます。変更された単語を強調表示し、長い行を折り返し、空白の変更を無視し、Markdown をプレビューし、ある変更から次の変更にジャンプします。

GitTree からのファイルを無視します

ビルド出力やローカル設定など、コミットしたくないファイルは .gitignore に属します。作業変更内の新しいファイルを右クリックし、無視するものを選択するか、.gitignore を Edit .gitignore… で直接編集します。

パッチを作成して適用する

パッチは、あるリポジトリから別のリポジトリに変更を伝達するファイルです。 GitTree は、ファイルの変更または 1 つ以上のコミットをパッチとして保存し、パッチを作業ツリー、ステージング済み、または現在のブランチのコミットとして適用します。

イメージとバイナリの変更を確認する

テキストの差分では画像を表示できません。 PNG、JPEG、GIF、WebP、またはその他の画像が変更されると、GitTree は前後の画像を比較します: Side by side、Swipe、または Onion skin。他のバイナリ ファイルにはそのサイズが表示されます。

追跡ファイルのインデックスフラグを管理する

場合によっては、ローカル構成など、コンピューター上でのみ追跡されたファイルを変更することがあります。 2 つの Git フラグはそのような変更を隠します。Skip Worktree… はコピーを保持し、変更の表示を停止します。 Assume Unchanged… は、Git によるファイルのチェックを停止する高速化です。どちらもファイルを無視する方法ではありません。

ブランチの作成と切り替え

ブランチは、作業ラインの移動可能な名前です。 GitTree では、ツールバーの Branch によって、現在のコミットに 1 つが作成されます。任意のコミットを右クリックして、そこにコミットを作成します。ブランチ ラベルをダブルクリックして、そのラベルに切り替えます。

ブランチの名前変更と削除

Rename と Delete のブランチ ラベルを右クリックします。ローカル ブランチを削除すると、最初に最後のコミットが refs/ogt/trash に保存されるため、Undo はそれを元に戻します。リモートでの削除は、明確に名前が付けられた別個の選択肢です。

タグの作成と管理

タグは 1 つのコミットの固定名で、通常は v2.2.0 などのリリースです。コミットを右クリックして Tag Here を選択し、軽量タグまたは注釈付きタグを選択します。タグはコミットとともにプッシュされません。それぞれを Push Tag でプッシュします。

トラッキングを設定してブランチを公開する

新しいブランチは、プッシュするまでコンピュータ上にのみ存在します。最初の Push は、どのリモートに送信するかを尋ね、それ以降、ブランチは git push -u のようにそのリモート ブランチ (その上流) を追跡します。 Set Upstream… は追跡対象を変更します。

ブランチとタグを比較する

Compare References… は、任意の 2 つのブランチ、タグ、リモート ブランチ、またはコミットを名前で比較します。これには、一方が他方よりも先にあるコミットと他方のコミットの後にあるコミットの数、および異なるファイルが表示されます。すべての違い (git diff A B) または分割後に新しい側が変更した内容のみ (A...B、プル リクエストで表示される内容) のいずれかです。

Gitflow アクションを使用する

Gitflow は、運用ブランチ、開発ブランチ、機能、リリース、ホットフィックス ブランチを備えた分岐モデルです。 GitTree の Gitflow セクションはそれを初期化し、それらのブランチを開始および終了し、マージ、タグ付け、削除を行います。

切り離された HEAD を認識して放置する

ブランチの代わりにコミットまたはタグをチェックアウトすると、detached HEAD が表示されます。どのブランチにも存在しません。周りを見回してコミットすることもできますが、新しいコミットはどのブランチにも属しません。ブランチを作成してそれらを保持するか、ブランチをチェックアウトして元に戻ります。

フェッチ、プル、プッシュ

Fetch は、作業を変更することなく、新しいものをリモコンにダウンロードします。 Pull はブランチの上流をそこに組み込みます。 Push はコミットをリモートに送信します。 3 つはすべてツールバーにあり、オプションはその横の矢印メニューにあります。

リモコンの追加と編集

リモートは、GitHub の origin など、別の場所にあるリポジトリの名前付きコピーです。左側のパネルの Remote セクションにそれらのリストが表示されます。 Add Remote… はリモートを追加し、リモートを右クリックして編集、フェッチ、プルーニング、または削除します。

リモート認証情報を選択してください

GitTree は独自の Git を実行するため、コンピューター上で Git が行うのと同じ方法で署名の取得、プル、プッシュを行います。資格情報ヘルパーを介して HTTPS 経由で、キーまたは SSH エージェントを使用して SSH 経由で実行されます。パスワードとトークンはシステム キーチェーンに保存され、GitTree のファイルには保存されません。

自動取得を構成する

自動フェッチにより、Fetch All を押さなくても、グラフ内のリモート ブランチが最新の状態に保たれます。開いているすべてのリポジトリに対して数分で Auto-fetch interval を設定し、1 つのリポジトリに対してそれをオーバーライドし、新しいコミットが到着したときにデスクトップ通知を受け取ります。

リースで強制プッシュを使用する

すでにプッシュしたコミットを修正、リベース、またはリセットすると、通常のプッシュは拒否されます。 Force Push (With Lease)… はリモート ブランチを自分のブランチに置き換えますが、それは git push --force-with-lease のように最後にフェッチした場所に残っている場合に限られます。 GitTree は他の方法で強制プッシュすることはありません。

限られたリポジトリ履歴を使用して作業する

浅いクローンは最新のコミットのみをダウンロードします。ブロブレス クローンは、必要な場合にのみファイルの内容をダウンロードします。どちらも巨大なリポジトリを素早く複製できます。浅いクローンでは、グラフは履歴がどこで停止するかを示し、Fetch More History または Fetch Full History が残りをもたらします。

ブランチをマージする

マージすると、git merge など、別のブランチのコミットが現在のブランチに取り込まれます。他のブランチを右クリックして、Merge … into … を選択します。GitTree では、最初に競合がチェックされ、マージの記録方法を選択できます。

ブランチをリベースする

リベースすると、ブランチのコミットが別のブランチの上にリプレイされるため、履歴は git rebase のように直線のままになります。コミットは新しい ID を取得します。 GitTree は古いブランチを refs/ogt/trash の下に保持し、Undo はそれを戻します。

マージ競合を解決する

両方のブランチが同じ行を変更すると、競合が発生します。 GitTree のリゾルバーには、A と B の 2 つのバージョンが並べて表示されます。各競合を保持する行にチェックを入れ、Output、次に Save をチェックして、マージ、リベース、またはチェリーピックを続行します。

コミットを厳選して元に戻す

Cherry-Pick Commit は、1 つのコミットの変更を新しいコミットとして現在のブランチにコピーします (git cherry-pick など)。 Revert Commit は、git revert のように、コミットを取り消す新しいコミットを追加します。これは、すでにプッシュされたものを取り戻す安全な方法です。

操作を続行、スキップ、または中止する

マージ、リベース、チェリーピック、またはリバートは、通常は競合により途中で停止することがあります。グラフの上のバナーにはオペレーションとそのステップの名前が表示され、Resolve、Continue、Skip (リベース)、および Abort… が提供されます。中止すると最初にドロップしたものが保存されるため、Undo はそれを戻します。

記録された競合解決を再利用する

Reuse recorded resolutions (rerere) をオンにすると、Git は競合を解決した方法を記憶し、リベースの繰り返し中などに競合が再発したときに同じ解決策を書き込みます。 GitTree は、いつ発生したかを通知し、ファイルを解決済みとしてマークする前にそれを確認できます。

インタラクティブなリベースによる履歴の編集

インタラクティブなリベースでは、選択したコミットより上のコミットを書き換えます。それぞれを保持、書き換え、編集、潰し、修正または削除し、git rebase -i などの新しい順序にドラッグします。単一の変更の場合、コミットのメニューの Edit History は 1 ステップで実行します。

コミットをスカッシュする

Squashing combines several commits into one, like a fixup or squash in git rebase -i. GitTree では、すべてのスカッシュで最初に Squash ダイアログが開きます。ダイアログには、フォールドされたコミット、結果、メッセージ、クレジットの取得者が表示され、確認するまで何も変更されません。 Your uncommitted work is never touched, and Undo puts the commits back.

選択したローカルコミットを変更する

履歴を 1 回簡単に変更する場合、インタラクティブなリベース エディター全体は必要ありません。コミットの Edit History メニューは、メッセージを編集、削除、または上下に移動します。複数のコミットを選択すると、Squash ダイアログが開きます。 GitTree はその上のコミットを書き換えて古いブランチを保持するため、Undo はそれを元に戻します。

ブランチをコミットにリセットする

リセットすると、現在のブランチが別のコミット (git reset など) に移動します。 Soft はすべての変更をステージングし、Mixed は作業フォルダーに保持し、Hard は破棄します。 GitTree は最初に refs/ogt/trash の下にあるものをすべて保存するため、ハード リセットでも元に戻すことができます。

元に戻すとやり直し

GitTree は Git 操作を記録するため、ツールバーの Undo で最後の操作 (コミット、マージ、リベース、リセット、破棄、クリーン、削除されたブランチまたはタグ) を元に戻すことができます。 Redo はまた同じことをします。破壊的なステップでは、実行前に回復スナップショットが refs/ogt/trash に保存されます。

以前のブランチのヒントを見つける

reflog は、ブランチまたは HEAD が移動するたびに、コミット、チェックアウト、リセット、リベースなど、ブランチまたは HEAD が指した場所を記録します。 View Reflog… はそれらのエントリをリストします。グラフまたは Restore as Branch にコミットを表示するものを選択します。

ファイル履歴と責任

History は、git log --follow のように、名前変更後にファイルを変更したすべてのコミットをリストします。 Blame には、git blame のように、行ごとに、最後に変更したコミットと作成者が表示されます。どちらもファイル ワークスペースのビューです。

二等分ワークフローを使用する

Bisect は、問題が発生したコミットと問題を持たないコミットの間の履歴を半分にすることで、問題を引き起こした最初のコミットを見つけます (git bisect など)。 2 つのコミットを選択し、コミット GitTree のチェックアウトをテストして、Good または Bad とマークし、First bad commit という名前が付けられるまで繰り返します。

アーカイブをエクスポートする

Export Archive… は、git archive のように、.git フォルダーを使用せずに、コミット、ブランチ、またはタグのファイルを .zip または .tar.gz として書き込みます。これは、誰かにリリースのソースを渡す最も簡単な方法です。

リポジトリのメンテナンスと作成者ツールを使用する

Repository Maintenance… はオブジェクト データベースのサイズを表示し、それをチェックするタスクや履歴とステータスを高速化するタスクを実行します。 Merge Author Identities… は .mailmap 行を書くため、複数の名前または電子メールを持つ 1 人の人物が 1 人の作成者として表示されます。

ワークスペースを整理する

ワークスペースは、「クライアント A」や「モバイル」などの単位として開かれる、名前付きのリポジトリのセットです。ダッシュボードには、すべてのリポジトリのブランチ、同期状態、変更に加えて、それら全体で実行されるプル リクエストと CI/CD が表示されます。

保存されたリポジトリを管理する

各ワークスペースには、Saved repositories のリストが保持されます。現在のワークスペースであるときに開いたり、クローンを作成したり、作成したり、スキャンから追加したすべてのリポジトリはそこに保存され、タブが閉じた後も残ります。リストからそれらを一度に開くか、1 つを削除します。そのフォルダーは決して触れられません。

スタッシュの変更

スタッシュにより、コミットされていない変更が脇に置かれ、git stash などのクリーンな作業フォルダーが得られるため、タスクを切り替えて後で変更を戻すことができます。ツールバーの Stash はすべてを保存します。変更パネルの Stash タブでは、正確に何を選択しますか。

ワークツリーを使用して複数のブランチを操作する

ワークツリーは、同じリポジトリの 2 番目の作業フォルダであり、git worktree add などの独自のチェックアウトされたブランチがあります。プル リクエストをレビューし、長いビルドを実行するか、一方には何も隠さずにコーディング エージェントを動作させます。

サブモジュールの管理

A submodule is another repository pinned inside yours at a specific commit. GitTree は、それらを状態 (未初期化、最新、異なるコミット、競合) とともにリストし、追加、初期化、更新、オープン、編集、削除します。

Git LFS コントロールを使用する

Git LFS は、画像、ビデオ、モデルなどの大きなファイルをリポジトリの外部に保存し、小さなポインタ ファイルをその場所に保持します。 Git LFS… は、セットアップ、パターンの追跡、コンテンツのダウンロード、ファイルのロック、古いコンテンツの削除を行います。

プロジェクトファイルの参照と編集

左側のパネルの Files セクションにはプロジェクトのフォルダーが表示され、変更が含まれるフォルダーがマークされます。 Graph タブの横にあるタブでファイルを開いて読み取りまたは編集し、File、Changes、Blame、および History の間で切り替えます。

ファイルを開いて編集する

GitTree で開くファイルには、固定された Graph タブの横に独自のタブが表示されます。コミットからのファイルは読み取り専用です。 Edit in Working Directory はプロジェクト内のコピーを開いて編集し、Save します。その間にディスク上のファイルが変更された場合、GitTree は何も保存せず、ユーザーが選択できるようにします。

コミットグラフに戻る

差分、ファイル、非難、履歴、比較、パイプライン、プル リクエストがグラフ上で開きます。 Esc は一番上のビューを閉じ、それを開いたビューに戻ります。 Back to Graph はそれらをすべて一度に脱ぎます。開いているファイルは非表示のみです。そのタブは Graph タブの横に残ります。

内蔵端子を使用する

ツールバーの Terminal は、グラフの下のドロワーにあるリポジトリのルートでシェルを開きます。そこで Git を含む任意のコマンドを実行すると、グラフと変更が更新されます。各リポジトリ タブは独自のターミナルを保持します。

外部ツールを構成する

環境設定 › External Tools は、ファイル メニューと競合ビューから Editor、Diff tool、および Merge tool を選択します。GitTree が開きます。 Automatic は、最初にインストールされた Visual Studio Code、Cursor、および Antigravity を使用します。 Custom… は、指定した引数を使用して任意のプログラムを実行します。

カスタムアクションを作成して実行する

カスタム コマンドは、Custom actions ボタン、コミット、ブランチ、ファイル メニューからリポジトリ上で独自のプログラムを実行します。各引数は記述どおりに渡され、シェルは関与せず、コマンドの最初の実行では、実行前に実行される内容が正確に表示されます。

コマンドパレットでアクションを検索する

コマンド パレットは、名前の一部を入力することで任意の GitTree コマンドを実行し、ブランチ、コミット、ファイル、開いているリポジトリにジャンプします。 Ctrl+Shift+P (Mac の場合は ⌘⇧P) を押し、入力して Enter を押します。

キーボードショートカット

ほとんどの GitTree コマンドにはショートカットがあります。 Ctrl+/ (Mac の場合は ⌘/) を押すと、入力時にフィルターされたアプリ内の完全なリストが表示されます。 Customize… のいずれかが変更されます。以下の表にデフォルトを示します。

アクティビティと通知を検査する

Activity Log には、実行されたすべての git コマンド GitTree とその出力、かかった時間と失敗したかどうかがリストされます。 URL 内のトークン、パスワード、資格情報は削除されます。 Notifications はこのセッションに表示されるメッセージを保持し、設定 › Notifications はどのポップアップを表示するか、またシステムでもメッセージを表示するかどうかを決定します。

アプリ内機能ガイドを使用する

Feature Guide には、GitTree で実行できるすべての機能、その場所とそのショートカットがエリアごとにグループ化され、検索ボックスとともにリストされます。 Show me を使用すると、開いているリポジトリ内の機能が表示されます。リポジトリ、Pro、または接続されたアカウントを必要とする機能にはそのように記載されています。

GitHubを接続してください

GitHub に接続すると、GitTree でリポジトリ、プル リクエスト、問題、チェックを一覧表示できるようになります。ブラウザでサインインするか (推奨: GitHub のページで GitTree を承認する)、または個人アクセス トークンを使用します。トークンはシステムのキーチェーンにのみ保存されます。

GitLabを接続してください

GitTree は、gitlab.com または指定した自己管理型の GitLab ホストに接続します。 OAuth アプリケーション (gitlab.com GitTree の場合は独自のものが使用されます) を介してブラウザーでサインインするか、そのホストからの個人アクセス トークンを使用します。トークンはそのホストに対してのみ使用されます。

Bitbucket クラウドに接続する

GitTree は 3 つの方法で Bitbucket Cloud (bitbucket.org) に接続します。ブラウザで Bitbucket アカウントを使用してサインインするか、アカウントの電子メールで Atlassian API トークンを使用するか、ワークスペース、プロジェクト、またはリポジトリのアクセス トークンを使用します。トークンはシステムのキーチェーンにのみ保存されます。

Bitbucket データセンターに接続する

企業の Bitbucket データセンター サーバーの場合は、そのホストに名前を付けて、そのホストからの個人 HTTP アクセス トークンを使用するか、管理者が GitTree 用に作成した受信 OAuth アプリケーション リンクを介してブラウザでサインインします。 GitTree はそのホストとのみ通信します。

Azure DevOps に接続する

ブラウザーで Microsoft アカウントを使用してサインインするか、Azure DevOps の個人アクセス トークンを使用します。 GitTree は、dev.azure.com および Microsoft のプロファイル サービスと通信して組織を見つけ、リポジトリ、プル リクエスト、パイプラインを一覧表示します。

エンタープライズサーバーとセルフホストサーバーを接続する

GitTree は、会社独自のサーバー GitHub エンタープライズ サーバー、自己管理型 GitLab および Bitbucket データ センターに接続します。ホストに名前を付けます。 GitTree はそのホストのみ https:// と通信し、トークンはそのホストのみに使用されます。ブラウザーのサインインには、管理者がそこに登録した OAuth アプリケーションが必要です。

統合の可用性を確認する

プロバイダーはすべて同じものを提供しているわけではありません。機能ガイドの Integrations タブには、オープン リポジトリのプロバイダとアカウントについて、Available とは何か、そのプロバイダである Not offered by とは何か、および Coming soon とは何かが表示されます。

プロバイダリポジトリの参照と作成

アカウントが接続されていると、Clone a repository はそのアカウントのリポジトリを Owner で検索して一覧表示するため、URL をコピーする必要はありません。 Publish Repository… は逆の方法で、アカウントにリポジトリを作成し、それをリモートとして追加して、ブランチをプッシュします。

GitTree からのフォークを使用する

フォークは、プロバイダー上のリポジトリの独自のコピーです。 Create Fork… はプロバイダーに作成を依頼します。 Add Remote from Fork… は既存のフォークをリモートとして追加します。フォークを作成しても、追加するまでリポジトリは何も変更されず、既存のリモートが置き換えられることはありません。

プルリクエスト

ホスティング アカウントが接続されている場合、GitTree は左側のパネルにリポジトリのプル リクエストをリストし、グラフの横に各リクエスト (Review… と Merge… による会話、コミット、ファイル、チェック) を開きます。プル リクエストは GitTree Pro の一部です。

プルリクエストまたはマージリクエストを作成する

ブランチを右クリックして、Start a Pull Request… を選択します。 From と Into を結合するものを選択し、Title と Description を記述し、レビュー担当者 (オプションで Open as a draft) を追加して、Create Pull Request を押します。まだリモート上にないブランチが最初にプッシュされます。

変更を確認して話し合う

pull リクエストを開き、Files を読み、行の横にある + を押してレビューに行コメントを追加します。 Review… は、Summary と各行コメントを付けて決定 (Approve、Request changes、または Comment) を送信します。プロバイダーがサポートしている場合は、会話に返信したり解決したりできます。

プルリクエストをマージまたはクローズする

Merge… はプロバイダにプル リクエストのマージ方法を問い合わせ、それが Ready to merge であるかどうかを示し、リポジトリが許可する Merge method のみを提供します。 GitTree は、ヘッドがまだ確認したコミットである間にのみマージされます。新しいコミットが到着した場合、何もマージされません。

サポートされている問題アクションを使用する

左側のパネルの Issues セクションには、リポジトリの未解決の問題がリストされます。開いて読んだりコメントしたり、New Issue… で作成したり、Create Branch from Issue… で作業を開始したりできます。閉じたり編集したりする際の問題は、プロバイダーのページ Open Issue in Browser で発生します。

チェックとコミットのステータスを検査する

GitTree は、コミットとプル リクエストの CI 状態を示します: Checks passing、Checks failing、Checks running、Checks skipped、または No checks reported、成功数、失敗数、実行数、またはスキップされた数を示します。それを選択して実行を確認したり、チェックのログを開くか、Re-run Check を開きます。

CI/CD の実行

GitTree は、リポジトリのホスト（GitHub アクションなど）の CI/CD 実行を、左側のパネルとグラフの横の完全なリストに表示します。成功したもの、失敗したもの、およびその理由が、Re-run Failed Jobs、Cancel Run…、Run Workflow… とともに表示されます。 CI/CD は GitTree Pro の一部です。

実行の参照とフィルタリング

CI/CD リストにはリポジトリのすべての実行が表示され、実行中に自動的に更新されます。 Filtersは、Branch、Workflow、Status、Triggerで絞り込みます。 Mine はランニングを続けます。 Watch はバックグラウンドで実行を更新し続け、完了したときに通知します。

ジョブとログを読み取る

実行を開き、ジョブまたはステップを選択して、Log タブでログを読み取ります。 Jump to first error はエラーに直接進み、Search the log… はテキストを検索し、Timestamps と Wrap はビューを変更し、Following は実行中のジョブのライブ出力をビューに保持し、Save Log… はそれをファイルに書き込みます。

パイプラインを再実行またはキャンセルする

実行から、Re-run Failed Jobs は失敗したもののみを繰り返し、Re-run All Jobs はすべてを繰り返し、ジョブのメニューはそのジョブのみを再実行します (GitLab スタイルのステージでは Retry Stage)。 Cancel Run… はそれを止めます。 Force Cancel Run… はジョブをクリーンアップせずに終了します。どちらのキャンセルも元に戻すことはできません。

ワークフローを実行する

Run Workflow… は、workflow_dispatch トリガーを使用した GitHub アクション ワークフローや Bitbucket custom パイプラインなど、手動で実行できるワークフローを開始します。 GitTree は、選択したブランチのワークフロー ファイルから入力を読み取り、それぞれのフィールドを表示します。

利用可能なアーティファクトをダウンロードする

実行の Artifacts タブには、生成されたファイルが Name、Size、およびいつ Expires で生成されたかがリストされます。 Save… は、プロバイダーが保存する場所を尋ね、そこにダウンロードします。 zip は zip として保存されますが、GitTree はそれを開きません。

デプロイメントと環境を検査する

デプロイを実行すると、Deploys to … と Environments タブが表示されます。各環境、そのデプロイメント、ブランチまたはコミット、およびそのタイミングが表示されます。待機中のデプロイメントには Waiting for approval が表示されます。あなたがレビュー担当者の 1 人である場合、Approve Deployment… と Reject Deployment… はそれに基づいて行動します。これらは誰にとっても状況を変えるものであり、元に戻すことはできません。

パイプライン ファイルの作成と確認

New CI/CD File… は、プロバイダが読み取るスターター ファイル（.github/workflows/ や .gitlab-ci.yml など）を書き込みます。既存のファイルに上書きすることはありません。 GitTree で編集し、Check with … を押してプロバイダーに検証してから、他のファイルと同様にコミットします。

パイプライン設定を管理する

CI/CD Settings は、プロバイダが別のアプリに管理できる内容を示します: Variables、Secrets、Environments、Runners、Schedules、Caches、Definitions、Releases。シークレットの値は、安全なシステム プロンプトに入力されるか、選択したファイルから読み取られて、プロバイダーに直接送信されます。 GitTree は、他の場所に表示したり、保存したり、送信したりすることはありません。

パイプラインリリース制御を使用する

CI/CD Settings › Releases にはリポジトリのリリースがリストされます。 New Release は、Title、Notes (Markdown)、およびユーザーがダウンロードできるファイルを使用してタグに名前を付けます (またはブランチまたはコミットからタグを作成します)。リリースは、Save as a draft しない限り、リポジトリを参照できるすべてのユーザーに公開されます。

パイプラインの障害について Nour に質問する

Explain Failure は、失敗した実行に関する質問で Nour を開きます。 Nour は、毎回、ユーザーが承認した場合にのみ、失敗したステップのログ (最大 64 KiB) を読み取り、何が問題だったと考えられるか、何を試行すべきかを答えます。答えをアドバイスとして扱い、ログと照らし合わせて確認してください。

AI アシスタント Nour をセットアップする

Nour は GitTree の AI アシスタントです。 Claude Code、Codex、Gemini CLI など、すでに使用しているコーディング エージェント CLI を独自のサブスクリプションで実行します。GitTree はキーを決して参照しません。 Ask モードでは、Nour は見て答えるだけです。 Agent モードでは、許可された範囲内で動作できます。 Nour は GitTree Pro の一部です。

自分の仕事について Nour に質問してください

Nour は、チャットのリポジトリとチェックアウトされたブランチを常に知っています。ファイル、フォルダー、ブランチ、コミットまたはプル リクエストについて言及したり、ファイルを添付したり、他のブランチについて Nour に伝えたりするには、「@」と入力します。メッセージ ボックスの上のチップには What Nour is told が表示されます。スコープ ピッカーは、チャットが対象とするリポジトリを決定します。

Nour アプリのアクションを確認する

Agent モードでは、Nour はビューを開く、ステージング、コミット、フェッチ、プッシュなどの独自のコマンドを通じて GitTree で動作できます。各アクションは種類 (Look around、Change you can undo、Risky) に属しており、その種類に対するユーザーの選択に従います。危険なものは常に承認カードをクリックするのを待ちます。

コミットまたはプルリクエストの下書きを作成する

コミット ボックスとプル リクエスト ダイアログは、インストールしたコーディング エージェント CLI を使用してテキストを下書きできます。Generate commit message with … は段階的な変更を読み取り、Draft the title and description with … はブランチのコミットを読み取ります。あなたは下書きを確認して編集します。ボタンを押すまでは何もコミットされず、開かれません。

Nour セッションを管理する

すべてのチャットは Chat history のリポジトリごとに保存されます。 Stop は現在の応答を終了します。 Nour は、長期間何も出力しないエージェントも停止します。選択したエージェントが応答できない場合 (サインインしていない、使用量が残っていない、モデルが見つからない) 場合は、インストールされている別のエージェントが代わりに応答し、Nour がその理由を説明します。

Nour のプライバシーと回復を確認する

ファイルを変更する可能性がある各ターンの前に、Nour はワークツリーのスナップショットを保存します。 Changes from this turn は変更内容をリストし、Undo this turn はワークツリーを元に戻します。スナップショットには、リポジトリ外部のプッシュやファイルは含まれません。メッセージは、独自のプロバイダーのポリシーに従って、選択したエージェント CLI に送信されます。 GitTree は API キーを保存したり、モデル自体を呼び出したりすることはありません。

エージェントとモデルを構成する

設定 › Nour (AI) › Agents には、検出されたエージェント CLI GitTree がリストされ、Installed または Not installed とマークされています。 Agent for new chats、それぞれの Model (空の場合はエージェント独自のデフォルトを使用)、および First one installed に続く Automatic selection order を選択します。 Test は、このコンピュータ上でエージェントが動作することを確認します。

設定を見つけて変更する

環境設定には、General、Profiles、SSH、Integrations、Nour (AI)、External Tools、UI Customization などのエリアごとのページがあり、さらに開いているリポジトリごとに Repo-Specific Preferences があります。 Search preferences は、名前、説明、またはキーで設定を検索し、各設定は Saves to: App、Profile、または Repository の場所を示します。

見た目も言葉遣いも

環境設定 › UI Customization は、Theme (明るいバージョン、暗いバージョン、高コントラスト バージョン)、Follow the system appearance、Language (英語またはアラビア語、右から左に配置)、Zoom、Dates の表示方法、および Reduce motion を設定します。

Git とリポジトリの動作を構成する

設定 › General には、GitTree が Git を駆動する方法 (Git executable、Pull mode、Auto-fetch interval、リベース オプション、Long paths、Line endings) が含まれます。 Repo-Specific Preferences は、その Base branch、自動フェッチ、コミット テンプレート、ファイル変更の通知方法など、1 つのリポジトリの一部をオーバーライドします。

Git ID とプロファイルを管理する

プロファイルは、コミットの名前と電子メールに加えて、切り替え可能なオプションの署名キーと SSH コマンドです。デフォルトでは、Passed to each git command GitTree が実行されるため、~/.gitconfig は変更されず、リポジトリ自体の名前またはメールアドレスが優先されます。 Written to ~/.gitconfig により、すべての Git ツールがそれを使用します。

GitTree で SSH を構成する

設定 › SSH は、.ssh フォルダー内のキーを一覧表示し、新しいキーを作成し、SSH 構成から各ホストを表示し、接続をテストします。 GitTree は SSH エージェントを開始したり、~/.ssh/config や core.sshCommand を編集したりすることはありません。 SSH リモート用に選択したキーは、実行される git コマンドに渡されます。

コミットとタグ署名を構成する

設定 › Commit Signing は、Format (OpenPGP、SSH キー、または X.509) と Key、および Sign every commit と Sign every annotated tag を選択します。 Apply to Global Git Config を押すまでは何も書き込まれません。グラフとコミットの詳細には、各コミットの署名状態が表示されます。

ツールとファイルエンコーディングを構成する

UTF-8 ではない差分およびファイルは、設定 › Editor › Default encoding で読み取られます。バイトオーダーマークが常に優先され、適合しないバイトは�として表示されます。 Line endings (core.autocrlf) は git が CRLF と LF を変換する方法を決定し、Long paths は git に Windows 上で 260 文字を超えるパスを作成させます。

通知とログを構成する

環境設定 › Notifications は、システムから Where notifications appear、Show success notifications、および Desktop notifications するかどうかを設定します。 General の Extended logging は、問題の診断に役立つように、次回の起動からローカル ログに詳細を書き込みます。どこにも何も送信されません。

Nour 権限を構成する

2 つの設定は Nour にバインドされています。 What Nour may do in a repository は、エージェント自体がそこで実行できる内容を設定します: Read only、Edit files, no commands、または Everything, as in a terminal。 What Nour may do in GitTree は、アプリアクションの種類と領域ごとに、Never、Ask me first、または On its own を設定します。リスクのある変化は常に問いかけます。

統合リフレッシュの構成

環境設定 › Integrations は、GitTree がホスティング アカウントを読み取る方法を制御します。つまり、リストが Refresh pull requests, issues and checks までにどのくらい古いか、Refresh when I come back するかどうか、CI/CD ログのデフォルト、作成者の写真の取得元などです。読み取りは、GitTree の窓が前にある間のみ行われます。

設定をバックアップ、インポート、またはリセットする

設定 › General › Back up, restore and reset は、アプリの設定、プロファイル、Git 設定をファイルにエクスポートしたり、そのようなファイルをインポートしたり、すべてをリセットしたりします。エクスポートには、パスワード、トークン、アカウントの詳細、リポジトリの設定は決して含まれません。インポートからの Git 設定は、確認した後にのみ ~/.gitconfig に書き込まれます。

アップデートを確認してインストールする

GitTree が Git を見つけられません

GitTree は独自の Git インストールを使用し、バンドルしたりインストールしたりすることはありません。何も見つからない場合は、GitTree needs Git が表示されます。見つかったものが 2.39 より古い場合は、This Git is too old と表示されます。 Git をインストールまたは更新するか、Locate Git… を押して選択し、次に Check again を押します。

リポジトリが開かない

フォルダーを開けない場合、GitTree はその理由を示し、次のステップを提案します: This folder is not a Git repository (初期化または別の選択)、This cannot be opened as a repository (パスの欠落)、GitTree cannot read this folder (権限)、または This repository belongs to another user (Git の所有権の確認)。

変更が反映されない

GitTree は、システムの変更通知を通じて、他のプログラムで行われた編集を通知します。 WSL フォルダとネットワーク共有では、これらの通知は届かないため、代わりに Automatic が数秒ごとにフォルダをチェックします。それでも変更が表示されるのが遅い場合は、そのリポジトリのチェック モードを強制するか、手動で更新してください。

リモート認証の試行が失敗しました

Git は、最初に独自の資格情報ヘルパーまたは SSH キーを使用してリモートにサインインします。 … needs you to sign in. は何も答えられないことを意味します。 … refused the credentials sent for this repository. は、送信された内容が無効になっているか、許可されていないことを意味します。 Git が使用する認証情報を修正します。接続されたアカウントは、ヘルパーが何も持っていない場合、またはリポジトリとして選択した場合にのみ入力されます。

プッシュが拒否されました

プッシュは 3 つの理由のいずれかで拒否され、GitTree がどれかを示します。 The remote refused …: リモートにはブランチにはないコミットがあります。 The remote declined the push: フックまたはブランチ保護が、その理由とともに「いいえ」と言いました。 … moved: リースを使用した強制プッシュにより、最後に取得した場所にリモートが存在しないことが判明したため、何も置き換えられませんでした。

Git 操作には注意が必要です

マージ、リベース、チェリーピック、リバート、または二分化が途中で停止すると、GitTree は Rebasing … onto …, step 3 of 7 などのバナーを表示し、タブ rebase in progress をマークします。ほとんどのコマンドは完了するまで待機します。競合があれば解決してから、Continue、Skip ステップ、または Abort… で開始位置に戻ります。

統合アクションは使用できません

ホスティング アクションが使用できない場合、GitTree はサイレントに失敗するのではなく、その理由を示します。一般的な理由は次のとおりです。これは GitTree Pro の一部であるためです。リモートのホストにアカウントが接続されていません。トークンは再接続する必要があります。プロバイダー上のあなたの役割がそれを許可していません。プロバイダーはそれを提供しません。または、プロバイダーがしばらくリクエストを制限しています。

Nour を開始または終了できません

Nour はコンピューター上でコーディング エージェント CLI を実行するため、ほとんどの問題は CLI にあります。インストールされていない、サインインしていない、使用量が残っていない、設定したモデルが利用できない、Node.js が必要であるなどです。 GitTree は、制限されたリポジトリでのターンの開始、またはターンを取り消し可能にするスナップショットを保存できない場合にもターンの開始を拒否します。

パイプラインまたはログをロードできません

GitTree は、実行またはログが欠落している理由を示します: This repository’s host does not list … runs.、This log has expired on …、This account may not read logs here.、… offers no log from outside its own page.、またはプロバイダーがリクエストを制限していることを示します。ほとんどの場合、修正が 1 つあります。プロバイダーのページのみを開くものもあります。

キーリングまたは SSH リクエストが失敗しました

GitTree は、アカウント トークン、そのサインイン、および記憶された SSH パスフレーズをシステム キーチェーン、つまり macOS Keychain、Windows 資格情報マネージャー、または Linux の Secret Service (GNOME Keyring または KeePassXC) にのみ保持します。キーチェーンが「いいえ」を示すと、GitTree はアクセスを許可して再試行するように求めます。ファイルに戻ることはありません。

オフライン時に GitTree を使用する

GitTree はローカルファーストです。コミット、ブランチ、マージ、リベース、スタッシュ、履歴、元に戻すなど、すべてのローカル Git 機能は接続なしで動作します。フェッチ、プル、プッシュ、ホスティング統合、CI/CD、および Nour のプロバイダにはネットワークが必要です。オフライン中、GitTree は最後に読み取ったデータを表示し、その旨を示します。

サポートレポートを収集して共有する

GitTree がエラーを検出すると、このコンピュータにレポートが保存されます。どこにも何も送信されません。 Report a Bug… には、コピーされる内容 (トークンとパスワードが削除された保存されたレポート、または短い概要) が表示され、選択できるようになります。その後、GitTree ウェブサイトのサポート フォームが開き、それを貼り付けることができます。 Contact Support… はサポート アドレスに書き込みます。