@akiojin/gwt 6.24.0 → 6.25.0

package/README.ja.md

@@ -239,6 +239,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

@@ -239,6 +239,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.25.0",
   "description": "Interactive Git worktree manager with Coding Agent selection (Claude Code / Codex CLI / Gemini CLI)",
   "bin": {
     "gwt": "bin/gwt.js"