craftzdog/tmux-claude-session-manager

何を解決するか

このプロジェクトは、複数の並行する Claude Code セッションを、さまざまなプロジェクト間で管理する方法を提供します。AIエージェントがまだ作業中か、アイドル状態か、あるいはどの tmux セッションに存在するかを手動で追跡する必要がなくなり、単一のインターフェースから迅速に切り替えられるようになります。

動作方法

• セッション追跡: 実行中のエージェントとその現在のステータス（作業中、待機中、アイドル）を識別するための真実の情報源として claude agents --json を使用します。
• プロセスマッピング: プロセスID（PID）をTTYにマッピングし、さらにそのTTYをtmuxのパネルにマッピングすることで、各 Claude プロセスと対応する tmux パネルを紐づけます。
• ナビゲーション: fzf で駆動される中央のピッカーが、capture-pane を使って各エージェントのスクリーンをリアルタイムプレビューします。ユーザーは特定のエージェントにジャンプしたり、現在のディレクトリ用に新しいセッションを起動したり、終了したエージェントをピッカーから直接終了させることができます。
• 統合: tmuxプラグインとして統合され、display-popup を使ってシームレスなオーバーレイ体験を提供します。

対象ユーザー

複数のディレクトリで複数のAIエージェントを実行している Claude Code の開発者で、tmux内でそれらを一元的に監視・切り替えしたい方。

特徴

• リアルタイムステータス監視: セッションを開かずに、エージェントが working、waiting、またはアイドル状態かを即座に確認できます。
• 中央ピッカー: すべての実行中の Claude エージェントを一覧表示・フィルタリング・ジャンプできる単一のポップアップインターフェース。
• リアルタイムプレビュー: ピッカー内でエージェントの現在の出力をリアルタイムでキャプチャした画面を表示。
• スマートジャンプ: セッションが起動された元のウィンドウに自動的に切り替え、ポップアップでエージェントを再開。
• クイックランチャー: 単一のキーバインディングで、現在のディレクトリ用の Claude セッションを素早く起動または再接続。