🎭 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: エラー時の自動プロファイル切替
