recon 是一个专门为 Claude Code 用户打造的 tmux-native 管理面板。如果你经常同时开多个 Claude Code 会话处理不同任务，这个项目能让你的工作流从混乱变清晰。

问题场景

用 Claude Code 写代码时，常见的工作流是这样的：

  • 同时处理多个功能分支
  • 让 Claude 一边重构 API，一边写测试，一边排查 bug
  • 每个任务一个 tmux 窗口，切来切去搞不清楚哪个是哪个
  • 有些会话在等你确认，有些在跑任务，有些已经 idle 了

问题在于：没有全局视角。你得一个个窗口切换过去才能知道状态。

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 用户