recon は、Claude Codeユーザー専用に設計されたtmux-native管理パネルです。複数のClaude Codeセッションを同時に扱う作業を、混沌から明確なものに変えてくれます。

課題のシナリオ

Claude Codeでの開発中、よくあるワークフローはこうです：

  • 複数の機能ブランチを同時に処理
  • ClaudeにAPIリファクタリング、テスト作成、バグ調査を並行して任せる
  • 各タスクをtmuxウィンドウで開き、行き来してどれがどれか分からなくなる
  • 承認待ちのセッション、実行中のセッション、アイドル状態のセッションが混在

問題は：グローバルな視点がないこと。状態を確認するには、ウィンドウを一つずつ切り替える必要があります。

reconの解決策

reconはtmux上に可視化ダッシュボードを構築し、すべてのClaude Codeセッションの状態を集中表示します：

ピクセルアートによる状態可視化

各agentは可愛いピクセルアート風のキャラクターとして描画され、状態に応じて異なる外見を見せます：

状態外見意味
Working緑色の嬉しそうなblob、キラキラと足付きアクティブに作業中
Inputオレンジ色のしかめ面blob、点滅表示入力/承認待ち
Idle青色の眠っているblob、Zzzマークタスク完了、待機中
Newベージュ色の斑点模様の卵新規セッション、未対話

このデザインはサブモニターに表示するのに最適——一目見るだけで、誰が作業中で、誰がサボっていて、誰が対応を必要としているかが分かります。

プロジェクト別ルームシステム

  • 同一gitリポジトリのworktreesはルームを共有
  • monorepoのサブプロジェクトは独立したルーム（例：myapp vs myapp › tools/cli）
  • 2×2グリッドレイアウト、j/kでページ切り替え、1-4のショートカットで即入室

詳細なコンテキスト情報

┌─ recon — Claude Code Sessions ─────────────────────────────┐
│ # Session    Git(Project::Branch)   Directory    Status   │
│ 1 api-refactor  myapp::feat/auth    ~/myapp    ● Input   │
│ 2 debug-pipeline infra::main        ~/infra    ● Work    │
│ 3 write-tests   myapp::feat/auth    ~/myapp    ● Work    │
│ 4 code-review   webapp::pr-452      ~/webapp   ● Idle    │
└────────────────────────────────────────────────────────────┘

各行に表示される情報：セッション名、gitプロジェクトとブランチ、ディレクトリ、状態マーカー、モデルバージョン、コンテキスト使用量、最終アクティブ時間。

技術実装

reconのコアアーキテクチャはtmuxをベースにしています：

  • 各Claude Codeインスタンスは独立したtmux sessionで実行
  • reconは~/.claude/sessions/{PID}.jsonを読み取りセッション情報を取得
  • tmux capture-paneでステータスバーテキストをキャプチャし現在の状態を判断
  • Rust + ratatuiでTUIインターフェースを構築

インストールと使用

# リポジトリをクローン
git clone https://github.com/gavraz/recon
cd recon

# コンパイル（Rustが必要）
cargo build --release

# 実行
./target/release/recon

ショートカットキー：

  • j/k - 上下ナビゲーション
  • Enter - 選択したセッションに切り替え
  • v - 詳細表示
  • r - 更新
  • q - 終了

類似ツールとの比較

ツール方式可視化マルチセッション管理
tmux 標準手動ウィンドウ切り替えなし記憶に依存
recon統合ダッシュボードピクセルアート状態グローバル視点
aider —watchファイル監視なしシングルセッション

reconの独自性は、既存の作業方法を変えない点にあります——tmuxもClaude Codeもそのまま使える——グローバルビューが追加されるだけ。すでにtmux + Claude Codeの組み合わせを使っているユーザーにとって、これはゼロ移行コストの強化となります。

適用シナリオ

  • 複数の機能ブランチを同時にメンテナンスする開発者
  • Claude Codeを使った大規模リファクタリングプロジェクト
  • AIに異なるモジュールを並列処理させたいアーキテクト
  • サブモニターにAI作業状態を表示したい技術者

まとめ

reconは小さく洗練されたツールで、非常に具体的な問題を解決します：複数Claude Codeセッションの可視化管理。

158 starはまだ新しいプロジェクトであることを示していますが、アイデアは的を射ています。すでにtmux + Claude Codeのワークフローに没頭しているなら、このピクセルスタイルのダッシュボードは試す価値があります——少なくとも、単調なウィンドウリストよりも、これらの可愛いキャラクターの方が面白いですから。

プロジェクトrecon
言語Rust
Star 数158
リポジトリgithub.com/gavraz/recon
対象Claude Code + tmux ユーザー