@akiojin/gwt 6.1.0 → 6.3.0

package/README.ja.md

@@ -15,13 +15,14 @@ Rust版はCLI/TUIの主要フローとWeb UI（REST + WebSocket端末）まで
 ## 主要機能
 
 - **モダンTUI**: Ratatuiによるスムーズでレスポンシブなターミナルインターフェース
-- **フルスクリーンレイアウト**: リポジトリ情報付きの固定ヘッダー、枠線付きのブランチリスト、キーボードショートカット付きの常時表示フッター
+- **フルスクリーンレイアウト**: リポジトリ情報付きの固定ヘッダー、枠線付きのブランチリスト
 - **スマートブランチ作成**: ガイド付きプロンプトと自動ベースブランチ選択でfeature、bugfix、hotfix、releaseブランチを作成
 - **高度なワークツリー管理**: 作成、Worktreeのあるブランチのクリーンアップ、パス最適化を含む完全なライフサイクル管理
 - **Coding Agent 選択**: 起動時の対話型ランチャーでビルトイン（Claude Code / Codex CLI / Gemini CLI / OpenCode）または `~/.gwt/tools.json` 定義のカスタムを選択
 - **Coding Agent 統合**: 選択したコーディングエージェントをワークツリーで起動（Claude Codeは権限設定・変更処理の統合あり）
 - **GitHub PR統合**: マージされたプルリクエストのブランチとワークツリーの自動クリーンアップ
 - **変更管理**: 開発セッション後のコミット、stash、破棄の内蔵サポート
+- **tmux マルチエージェントモード**: tmux ペインを使用して複数のコーディングエージェントを並列実行（tmux 内で実行時に自動有効化）
 - **ユニバーサルパッケージ**: 一度インストールすれば全プロジェクトで一貫した動作
 
 ## インストール
@@ -135,6 +136,52 @@ gwt clean
 3. **ワークツリー管理**: 既存ワークツリーの表示、オープン、削除
 4. **ブランチクリーンアップ**: マージ済みPRやベースブランチと差分がないブランチ／ワークツリーをローカルから自動削除（Worktreeのないブランチは対象外）
 
+## キーボードショートカット
+
+### ブランチリスト画面
+
+| キー | 動作 |
+|-----|------|
+| `Enter` | 既存エージェントペインにフォーカス / 非表示ペインを表示 / ウィザードを開く |
+| `d` | エージェントペインを削除（確認あり） |
+| `v` | エージェントペインの表示/非表示を切り替え |
+| `Space` | ブランチの選択/選択解除 |
+| `Up/Down` | ブランチ間を移動 |
+| `PageUp/PageDown` | ページ移動 |
+| `Home/End` | 先頭/末尾のブランチへジャンプ |
+| `f` | フィルターモードに入る |
+| `r` | ブランチリストを更新 |
+| `c` | マージ済みブランチのクリーンアップ |
+| `x` | ワークツリーの修復 |
+| `l` | ログを表示 |
+| `?` | ヘルプ |
+| `q` / `Ctrl+C` | 終了 |
+
+### フィルターモード
+
+| キー | 動作 |
+|-----|------|
+| `Esc` | フィルターモードを終了 |
+| 入力 | ブランチ名でフィルター |
+
+## ステータスアイコンの凡例
+
+| アイコン | 色 | 意味 |
+|---------|-----|------|
+| `o` | 緑 | 安全 - コミットされていない変更やプッシュされていないコミットなし |
+| `!` | 赤 | 未コミット - ローカルに変更あり |
+| `^` | 黄 | 未プッシュ - リモートにプッシュされていないコミットあり |
+| `*` | 黄 | 未マージ - マージされていない変更あり |
+
+## エージェントステータス表示
+
+ブランチリストの右側に、実行中のエージェントが表示されます:
+
+| 形式 | 意味 |
+|------|------|
+| `[/] Claude 01:23:45` | 実行中のエージェント（スピナー、名前、稼働時間） |
+| `[BG] Claude 01:23:45` | 非表示（バックグラウンド）のエージェント（グレーアウト） |
+
 ## コーディングエージェント
 
 gwt は PATH 上のエージェントを検出し、ランチャーに表示します。
@@ -325,6 +372,27 @@ cargo run
 **Git ワークツリー競合**: クリーンアップ機能を使用して古いワークツリーを削除
 **GitHub認証**: PRクリーンアップ機能使用前に`gh auth login`を実行
 **バイナリが見つからない**: gwtバイナリがPATHに含まれていることを確認
+**Docker + tmux でのUnicode文字化け**: Dockerコンテナ内のtmuxでUnicode文字（Claude Codeのロゴなど）がアンダースコアに化ける場合、tmuxをUTF-8モードで起動してください:
+
+```bash
+tmux -u
+```
+
+または `~/.tmux.conf` に以下を追加:
+
+```
+set -gq utf8 on
+```
+
+Dockerコンテナ内でロケールのインストールと設定が必要な場合もあります:
+
+```bash
+apt-get update && apt-get install -y locales
+sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen
+locale-gen
+export LANG=en_US.UTF-8
+export LC_ALL=en_US.UTF-8
+```
 
 ### デバッグモード
 

package/README.md

@@ -15,13 +15,14 @@ The Rust implementation covers the core CLI/TUI workflow and the Web UI (REST +
 ## Key Features
 
 - **Modern TUI**: Built with Ratatui for a smooth, responsive terminal interface
-- **Full-screen Layout**: Persistent header with repo context, boxed branch list, and always-visible footer with keyboard shortcuts
+- **Full-screen Layout**: Persistent header with repo context and boxed branch list
 - **Smart Branch Creation**: Create feature, bugfix, hotfix, or release branches with guided prompts and automatic base branch selection
 - **Advanced Worktree Management**: Complete lifecycle management including creation, cleanup of worktree-backed branches, and path optimization
 - **Coding Agent Selection**: Choose between built-in agents (Claude Code / Codex CLI / Gemini CLI / OpenCode) or custom coding agents defined in `~/.gwt/tools.json`
 - **Coding Agent Integration**: Launch the selected agent in the worktree (Claude Code includes permission handling and post-change flow)
 - **GitHub PR Integration**: Automatic cleanup of merged pull request branches and worktrees
 - **Change Management**: Built-in support for committing, stashing, or discarding changes after development sessions
+- **tmux Multi-Agent Mode**: Run multiple coding agents in parallel using tmux panes (automatically enabled when running inside tmux)
 - **Universal Package**: Install once, use across all your projects with consistent behavior
 
 ## Installation
@@ -135,6 +136,52 @@ The tool presents an interactive interface with the following options:
 3. **Manage Worktrees**: View, open, or remove existing worktrees
 4. **Cleanup Branches**: Remove merged PR branches or branches identical to their base directly from the CLI (branches without worktrees are excluded)
 
+## Keyboard Shortcuts
+
+### Branch List Screen
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Focus existing agent pane / Show hidden pane / Open wizard |
+| `d` | Delete agent pane (with confirmation) |
+| `v` | Toggle agent pane visibility (show/hide) |
+| `Space` | Select/Deselect branch |
+| `Up/Down` | Navigate branches |
+| `PageUp/PageDown` | Page navigation |
+| `Home/End` | Jump to first/last branch |
+| `f` | Enter filter mode |
+| `r` | Refresh branch list |
+| `c` | Cleanup merged branches |
+| `x` | Repair worktrees |
+| `l` | View logs |
+| `?` | Help |
+| `q` / `Ctrl+C` | Quit |
+
+### Filter Mode
+
+| Key | Action |
+|-----|--------|
+| `Esc` | Exit filter mode |
+| Type | Filter branches by name |
+
+## Status Icons Legend
+
+| Icon | Color | Meaning |
+|------|-------|---------|
+| `o` | Green | Safe - No uncommitted or unpushed changes |
+| `!` | Red | Uncommitted - Has local changes |
+| `^` | Yellow | Unpushed - Has commits not pushed to remote |
+| `*` | Yellow | Unmerged - Has unmerged changes |
+
+## Agent Status Display
+
+In the branch list, running agents are displayed on the right side:
+
+| Format | Meaning |
+|--------|---------|
+| `[/] Claude 01:23:45` | Running agent (spinner, name, uptime) |
+| `[BG] Claude 01:23:45` | Hidden (background) agent (grayed out) |
+
 ## Coding Agents
 
 gwt detects agents available on PATH and lists them in the launcher.
@@ -325,6 +372,27 @@ End users can install the latest published package (via npm or the GitHub Releas
 **Git Worktree Conflicts**: Use the cleanup feature to remove stale worktrees
 **GitHub Authentication**: Run `gh auth login` before using PR cleanup features
 **Binary Not Found**: Ensure the gwt binary is in your PATH
+**Unicode Character Corruption in Docker + tmux**: If Unicode characters (like the Claude Code logo) appear as underscores in Docker containers with tmux, start tmux with UTF-8 mode:
+
+```bash
+tmux -u
+```
+
+Or add to your `~/.tmux.conf`:
+
+```
+set -gq utf8 on
+```
+
+You may also need to install and configure locales in your Docker container:
+
+```bash
+apt-get update && apt-get install -y locales
+sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen
+locale-gen
+export LANG=en_US.UTF-8
+export LC_ALL=en_US.UTF-8
+```
 
 ### Debug Mode
 

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@akiojin/gwt",
-  "version": "6.1.0",
+  "version": "6.3.0",
   "description": "Interactive Git worktree manager with Coding Agent selection (Claude Code / Codex CLI / Gemini CLI)",
   "bin": {
     "gwt": "bin/gwt.js"
   },
   "type": "module",
   "scripts": {
-    "postinstall": "node scripts/postinstall.js"
+    "postinstall": "node scripts/postinstall.js",
+    "prepare": "test -n \"$CI\" || npx husky install",
+    "lint:husky": "bash scripts/verify-husky-hooks.sh"
   },
   "keywords": [
     "git",

package/scripts/entrypoint.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+set -euo pipefail
+
+# Git設定（node:22-bookwormにはGitが含まれている）
+# グローバルGit設定（安全なディレクトリを追加）
+git config --global --add safe.directory /gwt
+
+# ユーザー名とメールの設定（環境変数から）
+if [ -n "${GITHUB_USERNAME:-}" ]; then
+    git config --global user.name "$GITHUB_USERNAME"
+fi
+
+if [ -n "${GIT_USER_EMAIL:-}" ]; then
+    git config --global user.email "$GIT_USER_EMAIL"
+fi
+
+# Git認証ファイルを環境変数から作成
+if [ -n "${GITHUB_USERNAME:-}" ] && [ -n "${GITHUB_PERSONAL_ACCESS_TOKEN:-}" ]; then
+    printf '%s\n' "https://${GITHUB_USERNAME}:${GITHUB_PERSONAL_ACCESS_TOKEN}@github.com" > /root/.git-credentials
+    chmod 600 /root/.git-credentials
+    git config --global credential.helper store
+fi
+
+# GitHub CLIの認証（GITHUB_TOKENが設定されている場合）
+if [ -n "${GITHUB_TOKEN:-}" ] && command -v gh &> /dev/null; then
+    if echo "$GITHUB_TOKEN" | gh auth login --with-token; then
+        echo "✅ GitHub CLI authenticated"
+    else
+        echo "⚠️  GitHub CLI authentication failed (non-fatal)" >&2
+    fi
+fi
+
+# .codexディレクトリのセットアップ
+# auth.jsonをホストと同期（クロスプラットフォーム対応）
+mkdir -p /root/.codex
+if [ -f /root/.codex-host/auth.json ]; then
+    # auth.jsonが誤ってディレクトリとして作成されている場合は削除
+    if [ -d /root/.codex/auth.json ]; then
+        echo "⚠️  Removing incorrectly created auth.json directory"
+        rm -rf /root/.codex/auth.json
+    fi
+
+    # ホストのauth.jsonが存在しない、または空、またはホスト側が新しい場合はコピー
+    if [ ! -f /root/.codex/auth.json ] || [ ! -s /root/.codex/auth.json ] || [ /root/.codex-host/auth.json -nt /root/.codex/auth.json ]; then
+        cp /root/.codex-host/auth.json /root/.codex/auth.json
+        chmod 600 /root/.codex/auth.json
+        echo "✅ Codex auth.json synced from host"
+    else
+        echo "✅ Codex auth.json is up to date"
+    fi
+else
+    echo "ℹ️  INFO: Codex auth.json not found on host (optional)"
+fi
+
+echo "🚀 Docker development environment is ready!"
+echo "   You can now build the project with: bun run build"
+echo "   Or start development with: bun run dev"
+echo ""
+
+# コマンドの実行（デフォルトはbash）
+exec "$@"

package/scripts/verify-husky-hooks.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PRE_PUSH="$ROOT_DIR/.husky/pre-push"
+PRE_COMMIT="$ROOT_DIR/.husky/pre-commit"
+PACKAGE_JSON="$ROOT_DIR/package.json"
+
+fail() {
+  echo "Husky hook verification failed: $1" >&2
+  exit 1
+}
+
+require_file() {
+  if [ ! -f "$1" ]; then
+    fail "Missing file: $1"
+  fi
+}
+
+require_contains() {
+  local file="$1"
+  local pattern="$2"
+  if ! grep -Fq "$pattern" "$file"; then
+    fail "Expected pattern not found in $file: $pattern"
+  fi
+}
+
+require_not_contains() {
+  local file="$1"
+  local pattern="$2"
+  if grep -Fq "$pattern" "$file"; then
+    fail "Unexpected pattern found in $file: $pattern"
+  fi
+}
+
+require_file "$PACKAGE_JSON"
+require_contains "$PACKAGE_JSON" "\"prepare\": \"bunx husky install\""
+require_contains "$PACKAGE_JSON" "\"lint:husky\": \"bash scripts/verify-husky-hooks.sh\""
+
+require_file "$PRE_PUSH"
+require_contains "$PRE_PUSH" "cargo clippy --all-targets --all-features -- -D warnings"
+require_contains "$PRE_PUSH" "cargo fmt --all -- --check"
+require_contains "$PRE_PUSH" "bunx --bun markdownlint-cli . --config .markdownlint.json --ignore target --ignore CHANGELOG.md"
+
+if [ -f "$PRE_COMMIT" ]; then
+  require_not_contains "$PRE_COMMIT" "cargo clippy --all-targets --all-features -- -D warnings"
+  require_not_contains "$PRE_COMMIT" "cargo fmt --all -- --check"
+  require_not_contains "$PRE_COMMIT" "markdownlint-cli"
+fi
+
+echo "Husky hook verification passed."