craftzdog/tmux-claude-session-manager

解决的问题

该项目提供了一种在不同项目之间管理多个并发 Claude Code 会话的方法。它消除了手动追踪哪些 AI 代理仍在工作、哪些处于空闲状态，或它们位于哪些 tmux 会话中的需求，使用户能够从单一界面快速在它们之间切换。

工作原理

• 会话追踪：使用 claude agents --json 作为真实数据源，识别正在运行的代理及其当前状态（工作、等待或空闲）。
• 进程映射：通过将进程 ID（PID）映射到 TTY，再映射到 tmux 窗格，将每个 Claude 进程与其对应的 tmux 窗格配对。
• 导航：由 fzf 驱动的中央选择器使用 capture-pane 提供每个代理屏幕的实时预览。用户可以从选择器中跳转到特定代理、为当前目录启动新会话，或直接在选择器中终止已完成的代理。
• 集成：作为 tmux 插件集成，利用 display-popup 实现无缝的覆盖体验。

适用人群

在多个目录中运行多个 AI 代理的 Claude Code 用户，希望在 tmux 内通过集中方式监控和跳转代理。

特色亮点

• 实时状态监控：无需打开会话即可立即查看代理是否处于 working、waiting 或空闲状态。
• 集中式选择器：单一弹出界面，用于列出、过滤并跳转到任何运行中的 Claude 代理。
• 实时预览：在选择器中实时捕获代理当前输出的屏幕画面。
• 智能跳转：自动切换回会话启动的原始窗口，并在弹出窗口中恢复代理。
• 快速启动器：通过单个快捷键快速启动或重新连接当前目录的 Claude 会话。