@akiojin/gwt 6.24.0 → 6.26.0

package/README.ja.md

@@ -145,7 +145,7 @@ gwt clean
 |-----|------|
 | `Enter` | 既存エージェントペインにフォーカス / 非表示ペインを表示 / ウィザードを開く |
 | `d` | エージェントペインを削除（確認あり） |
-| `v` | エージェントペインの表示/非表示を切り替え |
+| `v` | GitViewを開く（選択中ブランチのgit状態詳細） |
 | `Space` | ブランチの選択/選択解除 |
 | `Up/Down` | ブランチ間を移動 |
 | `PageUp/PageDown` | ページ移動 |
@@ -167,6 +167,20 @@ gwt clean
 | `Esc` | フィルターモードを終了 |
 | 入力 | ブランチ名でフィルター |
 
+### GitView画面
+
+GitView画面は、選択中ブランチの詳細なgit状態（ファイル一覧、直近コミット）を表示します。
+
+| キー | 動作 |
+|-----|------|
+| `Up/Down` | ファイル・コミット間を移動 |
+| `Space` | ファイルのdiffまたはコミット詳細を展開/折りたたみ |
+| `Enter` | PRリンクをブラウザで開く（ヘッダーにフォーカス時） |
+| `v` / `Esc` | ブランチリストに戻る |
+
+マウス:
+- ヘッダーのPRリンクをクリックするとブラウザで開きます。
+
 ## ステータスアイコンの凡例
 
 | アイコン | 色 | 意味 |
@@ -239,6 +253,58 @@ gwt は PATH 上のエージェントを検出し、ランチャーに表示し
 - `models` は任意です。定義するとモデル選択ステップが表示されます。
 - `versionCommand` は任意です。定義するとバージョン検出に使用されます。
 
+## Bareリポジトリワークフロー
+
+gwtは効率的なワークツリー管理のためにbareリポジトリワークフローをサポートしています。このアプローチではbareリポジトリ（`.git`データ）をワークツリーから分離し、より整理されたプロジェクト構成を提供します。
+
+### ディレクトリ構造
+
+```text
+/project/
+├── repo.git/           # Bareリポジトリ
+├── main/               # ワークツリー（mainブランチ）
+├── feature-x/          # ワークツリー（feature/xブランチ）
+└── .gwt/               # gwt設定
+    └── project.json
+```
+
+### Bareリポジトリのセットアップ
+
+```bash
+# bareリポジトリとしてクローン
+git clone --bare https://github.com/user/repo.git repo.git
+
+# bareリポジトリからワークツリーを作成
+cd repo.git
+git worktree add ../main main
+git worktree add ../feature-x feature/x
+```
+
+### Bareリポジトリでのgwt使用
+
+bareリポジトリまたはそのワークツリー内でgwtを実行した場合:
+
+| 起動場所 | ヘッダー表示 |
+|----------|-------------|
+| 通常リポジトリ | `Working Directory: /path [branch]` |
+| Bareリポジトリ | `Working Directory: /path/repo.git [bare]` |
+| ワークツリー（通常） | `Working Directory: /path [branch]` |
+| ワークツリー（bare方式） | `Working Directory: /path [branch] (repo.git)` |
+
+### `.worktrees/`方式からのマイグレーション
+
+既存の`.worktrees/`ディレクトリ方式を使用しているリポジトリがある場合、gwtはこれを検出してbareリポジトリ方式へのマイグレーションを提案します:
+
+1. **バックアップ**: `.gwt-migration-backup/`にバックアップを作成
+2. **bareリポジトリ作成**: `{repo-name}.git`を作成
+3. **ワークツリー移行**: 既存ワークツリーを新構造に移動
+4. **クリーンアップ**: 古い`.worktrees/`ディレクトリを削除
+5. **設定作成**: `.gwt/project.json`を作成
+
+### サブモジュールサポート
+
+ワークツリー作成時、gwtはサブモジュールが存在する場合は自動的に初期化します。これにより、ワークツリー作成直後からサブモジュールを使用できます。
+
 ## 高度なワークフロー
 
 ### ブランチ戦略

package/README.md

@@ -145,7 +145,7 @@ The tool presents an interactive interface with the following options:
 |-----|--------|
 | `Enter` | Focus existing agent pane / Show hidden pane / Open wizard |
 | `d` | Delete agent pane (with confirmation) |
-| `v` | Toggle agent pane visibility (show/hide) |
+| `v` | Open GitView (git status details for selected branch) |
 | `Space` | Select/Deselect branch |
 | `Up/Down` | Navigate branches |
 | `PageUp/PageDown` | Page navigation |
@@ -167,6 +167,20 @@ Mouse:
 | `Esc` | Exit filter mode |
 | Type | Filter branches by name |
 
+### GitView Screen
+
+The GitView screen shows detailed git status for a branch, including files and recent commits.
+
+| Key | Action |
+|-----|--------|
+| `Up/Down` | Navigate files and commits |
+| `Space` | Expand/collapse file diff or commit details |
+| `Enter` | Open PR link in browser (when focused on header) |
+| `v` / `Esc` | Return to branch list |
+
+Mouse:
+- Click on the PR link in the header to open it in your browser.
+
 ## Status Icons Legend
 
 | Icon | Color | Meaning |
@@ -239,6 +253,58 @@ Notes:
 - `models` is optional. If defined, model selection step will be shown for this agent.
 - `versionCommand` is optional. If defined, version detection will use this command instead of skipping version selection.
 
+## Bare Repository Workflow
+
+gwt supports a bare repository workflow for efficient worktree management. This approach keeps the bare repository (`.git` data) separate from worktrees, providing cleaner project organization.
+
+### Directory Structure
+
+```text
+/project/
+├── repo.git/           # Bare repository
+├── main/               # Worktree (main branch)
+├── feature-x/          # Worktree (feature/x branch)
+└── .gwt/               # gwt configuration
+    └── project.json
+```
+
+### Setting Up a Bare Repository
+
+```bash
+# Clone as bare repository
+git clone --bare https://github.com/user/repo.git repo.git
+
+# Create worktrees from bare repository
+cd repo.git
+git worktree add ../main main
+git worktree add ../feature-x feature/x
+```
+
+### Using gwt with Bare Repositories
+
+When you run gwt in a bare repository or its worktrees:
+
+| Location | Header Display |
+|----------|----------------|
+| Normal repository | `Working Directory: /path [branch]` |
+| Bare repository | `Working Directory: /path/repo.git [bare]` |
+| Worktree (normal) | `Working Directory: /path [branch]` |
+| Worktree (bare-based) | `Working Directory: /path [branch] (repo.git)` |
+
+### Migration from `.worktrees/` Method
+
+If you have an existing repository using the `.worktrees/` directory method, gwt will detect this and offer migration to the bare repository method:
+
+1. **Backup**: Creates backup in `.gwt-migration-backup/`
+2. **Create bare repo**: Creates `{repo-name}.git`
+3. **Migrate worktrees**: Moves existing worktrees to new structure
+4. **Cleanup**: Removes old `.worktrees/` directory
+5. **Configure**: Creates `.gwt/project.json`
+
+### Submodule Support
+
+When creating worktrees, gwt automatically initializes submodules if present. This ensures submodules are ready to use immediately after worktree creation.
+
 ## Advanced Workflows
 
 ### Branch Strategy

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akiojin/gwt",
-  "version": "6.24.0",
+  "version": "6.26.0",
   "description": "Interactive Git worktree manager with Coding Agent selection (Claude Code / Codex CLI / Gemini CLI)",
   "bin": {
     "gwt": "bin/gwt.js"