🎭 tmux × iTerm2 Integration

Version: 2.0.0 Last Updated: 2025-11-22 Priority: ⭐⭐⭐⭐ (P1 Level) Purpose: マルチAgent視覚化とtmux統合によるオーケストレーション

📋 概要

MiyabiマルチAgentシステムとiTerm2のDynamic Profilesを統合し、 視覚的フィードバックとUI/UX向上を実現します。

🎯 P0: 呼び出しトリガー

🔧 P1: コマンド一覧

基本コマンド（5個）

監視コマンド（3個）

ペイン操作（3個）

🚀 P2: Agent別プロファイル

Agent Types（5種）

一般プロファイル（6種）

⚡ P3: ワークフロー例

Example 1: Issue処理フル自動化

# Step 1: ショートカット読み込み
source ~/scripts/miyabi-shortcuts.sh

# Step 2: Issue処理開始
miyabi-start 789

# Step 3: 監視開始
miyabi-monitor-start miyabi-issue-789

# Step 4: セッションアタッチ
tmux attach -t miyabi-issue-789

# レイアウト:
# ┌──────────────┬──────────────┐
# │ 👑 Coord     │ ⚙️  CodeGen   │
# │   (紫)       │   (緑)       │
# ├──────────────┼──────────────┤
# │ 🐛 Debug     │ 🔍 Review    │
# │   (赤)       │ (オレンジ)    │
# └──────────────┴──────────────┘

Example 2: 既存セッション拡張

# セッションアタッチ
tmux attach

# CodeGenペイン追加
miyabi-add codegen

# Reviewペイン3つ追加
miyabi-add-multi 3 review

# ペイン%5をDebugモードに
miyabi-assign %5 debug

Example 3: YouTube Live配信

# 配信モード開始
miyabi-live-start
# → 透過0%、フォント20pt、赤カーソル

# Issue処理デモ
miyabi-start 789

# 配信終了
miyabi-live-end
# → 元のプロファイルに復帰

📊 状態監視システム

検出パターン

監視ログ

/tmp/miyabi-monitor/
└── pane_<id>.txt  # 各ペインのキャプチャログ

🛡️ エラーハンドリング

プロファイル切り替え失敗

# iTerm2再起動
killall cfprefsd && \
osascript -e 'quit app "iTerm"' && \
sleep 2 && \
open -a iTerm

セッション見つからない

# セッション一覧確認
tmux list-sessions

# 新規作成
miyabi-start <issue_number>

ペインID不明

# 全ペインID表示
miyabi-list
# または
tmux list-panes -a

📁 ファイル配置

プロファイル設定

~/Library/Application Support/iTerm2/DynamicProfiles/
└── MiyabiProfiles.json (11プロファイル)

スクリプト

~/scripts/
├── miyabi-tmux-iterm-integration.sh  # メインスクリプト
├── miyabi-agent-monitor.sh           # 状態監視
├── miyabi-add-pane.sh                # ペイン追加
├── miyabi-shortcuts.sh               # ショートカット
├── miyabi-profile-switcher.sh        # 時間別切替
├── miyabi-live-start.sh              # 配信開始
└── miyabi-live-end.sh                # 配信終了

✅ 効果測定

🔗 関連ドキュメント

📝 関連Skills

• Agent Execution: Agent実行との連携
• Rust Development: ビルド状態の視覚化
• Debugging: エラー時の自動プロファイル切替