hiroppy/tmux-agent-sidebar

何を解決するか

複数の tmux ウィンドウやセッションを手動で切り替えて AI コーディングエージェントを監視する必要がなくなります。tmux 環境内のどこにエージェントが実行されているかに関係なく、すべてのアクティブなエージェントを一元的に表示できます。

動作方法

このプロジェクトは、Claude Code、Codex、OpenCode などの AI エージェントと連携する tmux プラグインです。フックやプラグインを使用して、プロンプト、ツール呼び出し、タスク進捗などのエージェントメタデータを追跡し、専用のサイドバーに表示します。また、Git worktree のライフサイクルを管理し、1回のキーストロークで新規 worktree にエージェントを起動・終了できる機能も提供します。

対象ユーザー

tmux と AI コーディングエージェント（特に Claude Code、Codex、OpenCode）を使用し、エージェントの活動を一元的に監視し、ワークスペースを管理したい開発者です。

特徴

• 統合監視: すべての tmux セッションとウィンドウでエージェントを1つのサイドバーで追跡。
• リアルタイムメタデータ: プロンプト、応答のプレビュー、バックグラウンドシェルの状態、サブエージェントツリーのリアルタイム更新を表示。
• uma Worktree 管理: worktree と関連エージェントを迅速に作成・削除可能。
• ネイティブ通知: エージェントがタスクを完了、エラーを検出、または承認を要求したときにデスクトップ通知を送信。