🎭 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処理フル自動化
bash
# 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: 既存セッション拡張
bash
# セッションアタッチ tmux attach # CodeGenペイン追加 miyabi-add codegen # Reviewペイン3つ追加 miyabi-add-multi 3 review # ペイン%5をDebugモードに miyabi-assign %5 debug
Example 3: YouTube Live配信
bash
# 配信モード開始 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 | - |
監視ログ
code
/tmp/miyabi-monitor/ └── pane_<id>.txt # 各ペインのキャプチャログ
🛡️ エラーハンドリング
プロファイル切り替え失敗
bash
# iTerm2再起動 killall cfprefsd && \ osascript -e 'quit app "iTerm"' && \ sleep 2 && \ open -a iTerm
セッション見つからない
bash
# セッション一覧確認 tmux list-sessions # 新規作成 miyabi-start <issue_number>
ペインID不明
bash
# 全ペインID表示 miyabi-list # または tmux list-panes -a
📁 ファイル配置
プロファイル設定
code
~/Library/Application Support/iTerm2/DynamicProfiles/ └── MiyabiProfiles.json (11プロファイル)
スクリプト
code
~/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: エラー時の自動プロファイル切替