🎭 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: 呼び出しトリガー

トリガー	例
セッション作成	"create tmux session for issue"
Agent色分け	"color-coded agent panes"
状態監視	"monitor agent status"
ペイン追加	"add new agent pane"
配信準備	"YouTube Live setup"

---

🔧 P1: コマンド一覧

基本コマンド（5個）

コマンド	用途	頻度
miyabi-start <issue>	Issue処理開始（5ペイン自動作成）	高
miyabi-list	セッション・ペイン一覧	高
miyabi-assign <pane> <agent>	プロファイル割り当て	中
miyabi-switch <pane> <profile>	プロファイル切り替え	低
miyabi-help	ヘルプ表示	低

監視コマンド（3個）

コマンド	用途	頻度
miyabi-monitor-start <session>	状態監視開始（自動切替）	中
miyabi-monitor-stop	状態監視停止	低
miyabi-monitor <pane> <agent>	単一ペイン監視	低

ペイン操作（3個）

コマンド	用途	頻度
miyabi-add <agent> [v|h]	ペイン追加（v=縦, h=横）	中
miyabi-add-multi <count> <agent>	複数ペイン一括追加	低
miyabi-agents	利用可能Agent一覧	低

---

🚀 P2: Agent別プロファイル

Agent Types（5種）

Agent	アイコン	背景色	ショートカット	用途
coordinator	👑	紫 (#1A0F2E)	⌘7	全体統括・タスク割り当て
codegen	⚙️	緑 (#0F2E1A)	⌘8	コード生成・実装
review	🔍	オレンジ (#2E1F0F)	⌘9	コードレビュー・品質
debug	🐛	赤 (#2E0F0F)	⌘0	デバッグ・エラー解析
deploy	🚀	青 (#0F1F2E)	⌘-	デプロイメント

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

プロファイル	ショートカット	透過度	フォント	用途
Miyabi Minimal	⌘1	35%	18pt	朝の作業
Miyabi Focus	⌘2	10%	19pt	集中作業
Miyabi Vibrant	⌘3	25%	18pt	活発な作業
Miyabi Night	⌘4	5%	18pt	夜間作業
Miyabi Live	⌘5	0%	20pt	YouTube配信
Miyabi Designer	⌘6	18%	19pt	UI/UX設計

---

⚡ 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
# → 元のプロファイルに復帰

---

📊 状態監視システム

検出パターン

状態	検出パターン	プロファイル	通知
Error	error|failed|panic	Debug (赤)	🐛 エラー
Complete	complete|success|done	Vibrant (緑)	✅ 完了
Running	processing|building	Focus	-
Waiting	waiting|pending	Night	-
Idle	(その他)	Minimal	-

監視ログ

/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                # 配信終了

---

✅ 効果測定

指標	従来	現在	改善率
Agent識別時間	5秒	1秒	80%短縮
エラー発見時間	30秒	3秒	90%短縮
ペイン作成時間	2分	10秒	91%短縮
プロファイル切替	手動	自動	100%自動化

---

🔗 関連ドキュメント

ドキュメント	用途
MIYABI_ITERM2_INTEGRATION_PLAN.md	詳細設計書
MIYABI_QUICK_REFERENCE.md	クイックリファレンス
context/rust-tool-use-rules.md	MCP Tool最適化

---

📝 関連Skills

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