gitwand

GitWand

スマートな競合解決機能を内蔵した、高速なネイティブ Git クライアント

デスクトップ • 競合解決エンジン • CLI • MCP サーバー • アーキテクチャ • ロードマップ • コード署名

---

GitWand は、Tauri 2 と Vue 3 で構築された軽量なネイティブ Git クライアントです。変更、履歴、ブランチ、プッシュ／プルなど、日々のワークフロー全体をカバーし、さらに単純なマージ競合の自動解決、インラインコメント付きのPR コードレビュー機能、履歴を表示するメインビューとしてのGit Treeを備えています。v1.3 以降、AI がブランチ名の作成、PR の作成、ハンク単位のレビュー、セマンティックなスカッシュ、自然言語によるコミット検索など、ワークフローのあらゆる手順を支援します。v2.7 以降では複数リポジトリ対応のワークスペースと Worktree を追加し、v2.8 では Agent Sessions（MCP）、v2.9 では複数リポジトリを横断する Launchpad、v2.10 では GitHub、GitLab、Bitbucket、Azure DevOps を横断するマルチフォージのプルリクエストに対応しました。v2.13 ではインライン AI コードレビューを追加し、v2.18 では CI チェックの注釈を差分に直接表示します。v2.19 ではGitHub と Azure DevOps の OAuth デバイスフローによるサインイン（gh CLI は不要）とフォークをまたぐプルリクエストに対応しました。3.x 系では、AI 支援による作業を日々こなすためのツールとして GitWand を進化させています。v3.0 では複数リポジトリのダッシュボードを、アクションを優先度別に整理する受信トレイ「Today」へと刷新し、VS Code 拡張機能を Marketplace で公開しました。v3.2 では、隔離された Worktree でのワンクリック AI タスクを含むAI エージェントのタブを備えた統合ターミナルと、ドック可能なファイルエクスプローラー／エディターパネルを追加しました。

デスクトップアプリ

Git Tree

Git Treeは履歴を表示するメインビューです。フル解像度の DAG でブランチの構造を SVG として描画し、trunk の固定表示、レーンのクールダウン、WIP ノード、ref バッジを備えています。コミットをクリックすると差分を確認でき、右クリックするとチェックアウト、リセット、ブランチ作成、タグ付け、チェリーピックを実行できます。ブランチ、スタッシュ、タグはすべてここで管理でき、専用の別パネルは不要です。フィルターモード（v3.2）では、条件に一致するコミットのみが表示されるよう DAG を再計算します。ブランチ／作成者のクイック切り替え、日付ごとの区切り、ブランチ名のオートコンプリートに加え、PR のブランチを直接特定する #<PR number> 検索にも対応しています。

リポジトリビュー

ステージ済み、未ステージ、未追跡、競合中のファイルをサイドバーに表示し、メイン領域にはインライン差分を表示します。画面を切り替えずにステージ、ステージ解除、破棄、コミットを実行できます。行単位またはハンク単位で部分的にステージすることもできます。

コミットのワークフロー

概要と説明の入力欄、任意のコミット署名、Ctrl+Enter ショートカットを備えています。未プッシュのコミットは Git Tree から直接修正できます。ホバーすると鉛筆アイコンが表示され、既存のメッセージが入力済みのオーバーレイが開きます。

ブランチ

ヘッダーのブランチ名をクリックすると、ブランチの検索、切り替え、作成、削除ができます。専用のマージボタンから任意のブランチをマージできます。現在のブランチ以外では、コミット前にマージ結果をシミュレーションするマージプレビューボタンが表示されます。

マージのプレビュー

ブランチをマージする前に、GitWand は作業ツリーに手を加えることなく、git merge-base、git show、git merge-file -p --diff3 を使って結果を予測します。結果にはファイルごとの内訳が表示されます。

• 自動解決可能 — GitWand が自動で処理できます
• 部分的 — 一部のハンクは手動で解決する必要があります
• 手動 — 人間の判断が必要な複雑な競合です
• 追加／削除 — 片方でファイルが追加され、もう片方で削除されています

全体の結果はバッジで要約されます：Clean merge、100% auto-resolvable、または N conflicts to review。

プッシュとプル

先行／遅延コミット数を示すバッジカウンター付きで、ワンクリックでプッシュとプルを実行できます。自動フェッチはバックグラウンドで30秒ごとに実行されます。

差分ビューアー

サイドバイサイド表示とインライン表示を切り替えられ、設定はセッション間で保持されます。30以上の言語の構文強調表示、LCS による単語単位の差分表示、変更のない領域の折りたたみ、キャンバスミニマップ、ハンクの移動（前／次）、2列の行番号表示に対応しています。

ファイル履歴と blame

git log --follow によるファイルの全履歴、コミットごとにグループ化された blame ビュー、任意の2つのバージョン間のタイムトラベル差分を利用できます。

リポジトリ切り替えとワークスペース

ヘッダーにある現在のリポジトリ名をクリックすると、最近開いたリポジトリを表示するドロップダウンが開きます。お気に入りをピン留めして、ファイル選択ダイアログを使わずにすぐ切り替えられます。ワークスペース（v2.7）では、複数のリポジトリを1つのダッシュボードにまとめ、リポジトリ横断のステータス表示、連携したプッシュ／プル、ワークツリーのクイック作成（⌘⇧N）を利用できます。各プロジェクトタブにはワークツリーのサブメニュー（v3.2）があり、main とすべてのワークツリーが一覧表示されます。選択すると、追加のタブを開かずに、そのプロジェクトのチェックアウト先をその場で切り替えられます。

今日

今日（⌘L。v2.9 で Launchpad として導入され、v3.0 で再設計）は、リポジトリ横断の優先度付けされたアクション受信トレイです。進行中のすべての項目 — WIP、PR、Issue、Team — が緊急度別に整理され、各行には状態に応じた主要アクション（マージ・レビュー・解決・返信・失敗を確認）が表示されます。項目はピン留めまたはスヌーズでき、大規模なワークスペースでパフォーマンスを維持するため、Team タブは必要になるまで読み込まれません。

プルリクエストとコードレビュー

アプリを離れずに、GitHub、GitLab、Bitbucket、Azure DevOps のプル／マージリクエストを閲覧、作成、チェックアウト、マージできます。GitWand はリモートからフォージを自動検出し、適切なプロバイダーに振り分けます。アカウントは Settings で一度設定すれば利用できます。PR リストはサイドバーに表示され、差分、CI チェック、コメント、インラインレビューを含む詳細全体がメイン領域に表示されます。

• OAuth でサインイン — 「GitHub でサインイン」と「Azure DevOps でサインイン」は OAuth デバイスフローを使用します。トークンは OS のキーチェーンに保存され、GitHub PR のワークフローは REST API を使ってトークンなしで実行されるため、gh CLI は不要です（トークンが設定されていない場合は CLI 経由の方法も引き続き利用できます）
• フォークをまたぐプルリクエスト — origin がフォークの場合、上流の親リポジトリに対して直接 PR を作成できます（デフォルト）。また、上流に作成した PR も、自分のフォークの PR と並べて表示されます
• インラインコメント — 差分の行に紐付いたレビューコメントを読み書きできます。スレッド表示と、ワンクリックで適用できるコード提案（```suggestion ``` ブロック）に完全対応しています
• インライン CI チェック注釈 — 失敗したチェックの注釈が、ガターアイコン（❌/⚠/ℹ）とホバーツールチップで差分に重ねて表示され、サイドバーにはファイルごとの件数が表示されます（GitHub、GitLab、Bitbucket）
• レビューの送信 — 承認／変更をリクエスト／コメントに対応し、送信前のコメントを蓄積できる下書きキューも利用できます
• 🧠 インテリジェンスパネル — 競合の予測（マージ前に git merge-tree を実行）、ホットスポット分析、レビュー範囲、静的 AI 提案、ファイルレビュー履歴

エージェントセッション

エージェントパネル（v2.8）にはアクティブな MCP セッションが表示され、GitWand から Claude Code を直接起動できます。エージェントによる変更は差分ビューアーにリアルタイムで表示されます。MCP カタログ（Settings > MCP）から、任意の MCP サーバーをワンクリックでインストールできます。

統合ターミナルと AI タスク

ターミナルパネル（v3.2）は WebGL で描画され、インライン検索（Ctrl+F）、クリック可能なリンク、型別のタブ（shell、claude、codex）を備えています。各タブには専用のアイコンと未読出力を示すドットが表示されます。「Launch Claude Code」／「Launch Codex」を選択すると、実際の PTY タブが開きます。また、「New AI task」を選択すると、一時的な git worktree が作成され、そこに Claude Code のタブがワンクリックで開きます。エージェントは分離された環境で作業し、完了後はプロジェクトタブのサブメニューから変更をマージするか、worktree を削除できます。シェル実行ファイルのホワイトリスト、すべてのファイルシステム操作での safe_repo_path() の使用、PTY の孤立防止により、安全性を強化しています。

ファイルエクスプローラー／エディター

ドッキング可能なファイルパネル（v3.2。ドラッグ、サイズ変更、全画面表示に対応）では、git ls-files を使用して、gitignore を考慮したリポジトリ全体のツリーを表示します。ファイルを開くと、遅延読み込みの CodeMirror 6 エディターで、構文ハイライト、タブごとの元に戻す履歴、ロック／元に戻す／保存ツールバーを利用できます。AppDock の Files タイルからアクセスでき、リポジトリごとにレイアウトを設定できます。

設定

言語（英語、フランス語、スペイン語、ブラジルポルトガル語、簡体字中国語。OS による自動検出）、テーマ（ダーク／ライト／システム）、コミット署名、差分モード、外部エディター、Git バイナリのパス、切り替え時の動作（stash／確認／拒否）を設定できます。AI プロバイダーでは、API バックエンド（Claude／OpenAI 互換／Ollama）とローカル CLI エージェント（Claude Code、Codex、opencode、GitHub Copilot CLI）を設定でき、それぞれに専用のモデル選択機能があります。アカウントでは、フォージへのサインインを管理します。GitHub と Azure DevOps には OAuth デバイスフローを、その他には App Passwords／CLI を使用します。すべての設定はアプリの設定に保存されます。

インストール

ご利用のプラットフォーム向けの最新ビルドを GitHub Releases からダウンロードしてください。

• macOS — .dmg（ユニバーサル：Apple Silicon + Intel、Developer ID 署名済み、Apple による公証済み）
• Linux — .AppImage または .deb
• Windows — .msi または .exe

Windows では、winget を使ってインストールすることもできます。

winget install Devlint.GitWand

ソースから実行

git clone https://github.com/devlint/GitWand.git
cd GitWand
pnpm install

# Browser dev mode — no Rust needed
cd apps/desktop && pnpm dev:web

# Tauri desktop mode — requires Rust toolchain
# Install Rust: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

# Desktop Dev Build (In the apps/desktop/ folder)
pnpm --filter desktop tauri dev

# On linux you may have to run
WEBKIT_DISABLE_COMPOSITING_MODE=1 pnpm --filter desktop tauri dev

---

コンフリクト解決エンジン

GitWand のコアエンジン（@gitwand/core）は、Git の単純なマージコンフリクトを自動的に解決します。複雑なハンクや曖昧なハンクには一切手を加えません。

解決パターン

GitWand はパターンレジストリを使用します。分類器はパターンを優先順位順に評価し、それぞれが diff3（ベースが利用可能）、diff2 のどちらを必要とするか、または両方で動作するかを宣言します。

レジストリには12 個のパターンがあり、そのうち8 個は自動適用されます。残りの 4 個は、確認を求める解決案を提示するか、オプトイン方式であるか、ハンクに手を加えずそのまま返します。

パターン	優先順位	自動適用	説明	一般的な信頼度
same_change	10	はい	両方のブランチでまったく同じ編集が行われました	確実
delete_no_change	20	はい	一方の側でブロックを削除し、もう一方の側では変更しませんでした	確実
one_side_change	30	はい	一方のブランチだけでブロックが変更されました	確実
non_overlapping	40	はい	ブロック内の異なる位置への追加です	高
whitespace_only	50	はい	ロジックは同じで、インデントや空白だけが異なります	高
reorder_only	55	はい	行は同じで、順序だけが異なる純粋な並べ替えです	高
insertion_at_boundary	57	はい	両方の側で純粋な挿入が行われ、ベースはそのままです	高
value_only_change	60	はい	両方の側で同じスカラー値（バージョン、ハッシュ、タイムスタンプ）が変更されました	高～中
token_level_merge	65	いいえ、提案	同じ行にある互いに重複しないトークン編集をマージし、確認用の提案として提示します	中
refactoring_aware_merge	970	いいえ、オプトイン	名前変更または移動を検出し、競合箇所に反映します	高
llm_proposed	998	いいえ、オプトイン	モデルが解決案を提示し、マージ後に検証します	中
complex	999	いいえ	編集が重複しており、常に詳細なトレースとともに提示されます	低

信頼度の列は目安です。すべてのハンクには、固定ラベルではなく計算された ConfidenceScore が付与されます（下記を参照）。たとえば value_only_change は、変動しやすいトークンが全トークンに占める比率に基づいてスコアを算出し、しきい値を下回るハンクは即座に却下します。

レジストリパターンではありません： generated_file は、分類後に実行される独立した再分類処理です。ハンクのパスが生成ファイル用の glob（ロックファイル、バンドル、dist/、および generatedFiles 内のすべてのファイル）に一致すると、リゾルバーはそれを generated_file に書き換え、既定では推測による解決を避け、対処方法を示す理由とともに却下します。これは、実際のマージ 1,662 件での測定結果では、生成ファイルの自動マージが、ほぼすべてのケースでチームが実際に出荷した内容と異なっていたためです。GitWand は、ソースファイルを解決してからインストーラー／ビルドを再実行するよう案内します。.gitwandrc の resolveGeneratedFiles: true または gitwand resolve --resolve-generated を使うと、従来の「相手側を採用／セマンティックマージ」の動作に戻せます。generated_file は ConflictType に含まれますが、分類器のレジストリには含まれません。

複合信頼度スコア

各解決には、単純なラベルではなく ConfidenceScore オブジェクトが付与されます。

{
  score: 84,           // 0–100 composite score
  label: "high",       // "certain" | "high" | "medium" | "low"
  dimensions: {
    typeClassification: 90,  // certainty of the detected pattern
    dataRisk: 20,            // risk of data loss if auto-resolved
    scopeImpact: 10,         // impact of change size
  },
  boosters: ["Path matches generated-file pattern: lockfile"],
  penalties: ["Content will be regenerated — theirs assumed more recent"],
}

（resolveGeneratedFiles: true の場合の generated_file ハンクの形式です。既定では、生成ファイルはスコアを算出して適用するのではなく却下されます。上のパターン表を参照してください。）

スコアの計算式：score = typeClassification − dataRisk×0.4 − scopeImpact×0.15

形式対応リゾルバー

構造化ファイルでは、GitWand はテキストマッチングにフォールバックする前に、セマンティックリゾルバーを使用します。

• JSON / JSONC — JSON.parse／JSON.stringify を使い、キーごとに再帰的にマージします。ネストされたオブジェクトを処理し、解決できないスカラー競合を検出し、.jsonc のコメントを削除します。
• Markdown — ATX 見出し（H1～H6）に基づいてセクション単位でマージします。独立したセクションはマージし、同じセクションが両方の側で変更された場合はテキスト処理にフォールバックします。

設定可能なマージポリシー

プロジェクトのルートに .gitwandrc ファイルを作成し、解決戦略を定義します。

{
  "policy": "prefer-merge",
  "patternOverrides": {
    "*.lock": "prefer-theirs",
    "src/generated/**": "prefer-theirs",
    "CHANGELOG.md": "prefer-ours"
  }
}

利用可能なポリシー：prefer-ours、prefer-theirs、prefer-safety、prefer-merge、strict。

判定トレース

監査とデバッグのため、分類の各ステップは DecisionTrace に記録されます。

✓ src/config.ts — 3/3 resolved
  L12 [one_side_change] certain — Only the incoming branch modified this block.
  L25 [same_change] certain — Both branches made the exact same edit.
  L41 [value_only_change:json] high — Scalar value updated on one side (version field).

---

CLI

# Use directly with npx
npx @gitwand/cli resolve

# Or install globally
npm install -g @gitwand/cli

gitwand resolve              # Resolve all conflicted files in the repo
gitwand resolve --dry-run    # Preview without writing
gitwand resolve --verbose    # Detailed decision trace
gitwand status               # Show conflict status per file
gitwand resolve --ci         # CI mode: JSON output + semantic exit codes

拡張 JSON 出力

--ci / --json フラグを指定すると、複合信頼度スコア、判断のトレース、LLM による解決を待つハンクを含む、完全な構造化レポートが返されます。

{
  "version": "0.1.0",
  "timestamp": "2026-04-14T12:00:00.000Z",
  "summary": {
    "files": 2,
    "totalConflicts": 5,
    "autoResolved": 4,
    "remaining": 1,
    "allResolved": false
  },
  "files": [
    {
      "path": "src/config.ts",
      "totalConflicts": 3,
      "autoResolved": 3,
      "remaining": 0,
      "validation": {
        "isValid": true,
        "hasResidualMarkers": false,
        "syntaxError": null
      },
      "resolutions": [
        {
          "line": 15,
          "type": "one_side_change",
          "resolved": true,
          "explanation": "Only one side modified this block",
          "confidence": {
            "score": 95,
            "label": "certain",
            "typeClassification": 100,
            "dataRisk": 5,
            "scopeImpact": 10
          },
          "trace": {
            "selected": "theirs",
            "hasBase": true,
            "summary": "One-side change detected — incoming accepted.",
            "steps": ["..."]
          }
        }
      ],
      "pendingHunks": []
    }
  ]
}

pendingHunks 配列には、GitWand が自動解決できない競合に対処するために AI エージェントや CI スクリプトが必要とするすべての情報が含まれています。ours／theirs／base の内容、分類のトレース、信頼度の内訳です。

---

MCP サーバー

GitWand には、競合解決エンジンを AI エージェント（Claude Code、Claude Desktop、Cursor、Windsurf、および MCP 互換のあらゆるクライアント）に公開する MCP（Model Context Protocol）サーバーが付属しています。

セットアップ

MCP クライアントの設定（例：claude_desktop_config.json または .claude/settings.json）に、次の内容を追加します。

{
  "mcpServers": {
    "gitwand": {
      "command": "npx",
      "args": ["-y", "@gitwand/mcp"]
    }
  }
}

サーバーはデフォルトでクライアントの作業ディレクトリを使用します。特定のリポジトリに固定するには、args 配列に "--cwd", "/absolute/path/to/repo" を追加します。Claude Code では、次の 1 行でインストールできます。

claude mcp add gitwand -- npx -y @gitwand/mcp

ツール

ツール	説明
gitwand_status	競合ファイルと、その複雑さおよび自動解決可能かどうかを一覧表示します
gitwand_resolve_conflicts	簡単な競合を自動解決し、DecisionTrace と pendingHunks を返します
gitwand_preview_merge	解決をドライランします。ファイルを書き込まずに統計情報とリスク評価を返します
gitwand_explain_hunk	特定のハンクがその種類に分類された理由を説明します（完全なトレースとコンテキスト）
gitwand_apply_resolution	特定の複雑なハンクにカスタム（LLM が提供する）解決を適用します
gitwand_resolve_hunk	接続されたエージェントに、未解決のハンク 1 つの解決案を提示するよう依頼します（ours／theirs／base とトレースを返します）
gitwand_resolve_hunk_llm	LLM が提案した解決をマージ後のゲートで検証し、ディスクに適用します

リソース

URI	説明
gitwand://repo/conflicts	現在の競合状態。ファイル、件数、種類
gitwand://repo/policy	有効な .gitwandrc 設定
gitwand://hunk/{file}/{line}	特定の競合の未加工ハンク内容

人間 ↔ LLM の協働ループ

MCP サーバーを使うと、GitWand が簡単な競合を自動処理し、LLM が複雑な競合に対処する強力なワークフローを実現できます。

1. LLM が gitwand_preview_merge を呼び出す — 競合の件数と、GitWand が処理できる件数を確認します
2. LLM が gitwand_resolve_conflicts を呼び出す — GitWand が簡単な競合を自動解決し、残りの pendingHunks を返します
3. LLM が pendingHunks を読み取る — 各ハンクには ours／theirs／base の内容と完全な判断トレースが含まれています
4. LLM が保留中の各ハンクについて gitwand_apply_resolution を呼び出す — 解決内容を直接書き込みます

Claude Code のスラッシュコマンド

GitWand には、Claude Code 用の .claude/commands/ も付属しています。

/resolve   # Full conflict resolution workflow
/preview   # Merge preview and risk assessment

---

アーキテクチャ

gitwand/
├── packages/
│   ├── core/       @gitwand/core — Resolution engine (TypeScript, browser-safe)
│   │               parser, resolver, classifier, format resolvers,
│   │               confidence scoring, tree-sitter structural dispatch
│   ├── cli/        @gitwand/cli — Command-line interface
│   ├── mcp/        @gitwand/mcp — MCP server (stdio transport)
│   │               tools (7), resources (3), Claude Code commands
│   └── vscode/     VS Code extension — CodeLens, diagnostics, status bar
├── apps/
│   └── desktop/    Tauri 2 + Vue 3 desktop app
│                   src-tauri/  Rust backend (git commands, IPC, libgit2)
│                   src/        Vue frontend (stores, composables, panels)
└── .claude/
    └── commands/   Claude Code slash commands (/resolve, /preview)

コアエンジンはフレームワークに依存せず、ライブラリとして使用できます。

import { resolve } from "@gitwand/core";

const result = resolve(conflictedContent, "src/app.ts");
console.log(`${result.stats.autoResolved}/${result.stats.totalConflicts} resolved`);

// With options
const result = resolve(content, "package.json", {
  policy: "prefer-merge",
  minConfidence: "medium",
  patternOverrides: { "*.lock": "prefer-theirs" },
});

---

開発

git clone https://github.com/devlint/GitWand.git
cd GitWand
pnpm install
pnpm build          # Build all packages
pnpm test           # Tests across all workspaces

ベンチマークの実行

cd packages/core
pnpm test:bench     # vitest bench — ops/s per fixture size

Apple M シリーズでのベースライン結果：

入力	スループット
1 件の競合／約 30 行	約 249 000 ops/s
5 件の競合／約 140 行	約 40 000 ops/s
50 件の競合／約 1350 行	約 4 500 ops/s
JSON／Markdown 形式を考慮	約 137 000 ops/s

国際化

GitWand は、5 つの言語（英語（en、デフォルト）、フランス語（fr）、スペイン語（es）、ブラジルポルトガル語（pt-BR）、簡体字中国語（zh-CN））に対応した、依存関係ゼロの型安全な i18n システムを使用しています。en.ts が as const で定義された規範的な参照元です。Locale 型と LocaleKey 型はこれを基に導出されるため、ほかのすべてのロケールは同じ構造にする必要があり、TypeScript によってそれが保証されます。useI18n() コンポーザブルは、ドット区切りのキー解決と位置指定の補間に対応した t(key, ...args) を提供します。OS の言語は自動検出されますが、ユーザーは設定で上書きできます。

---

ロードマップ

今後の機能、競合分析、リリース済みバージョンの履歴を含む段階的な計画の全容については、ROADMAP.md をご覧ください。

---

コード署名ポリシー

GitWand の Windows ビルドにはコード署名が付与されています。無料のコード署名は SignPath.io が提供し、証明書は SignPath Foundation が提供しています。

役割	メンバー
コミッター／レビュアー	Laurent Guitton
承認者	Laurent Guitton

このプログラムは、ユーザーから明示的に要求されない限り、ネットワークに接続されたほかのシステムに情報を転送しません。

---

ライセンス

MIT — Laurent Guitton