Summary

recon is a terminal-based dashboard designed to streamline the management of multiple Claude Code agents. It targets developers who frequently use Claude Code within tmux, offering a centralized interface to monitor agent activity, switch contexts, and control sessions without leaving the terminal, thereby enhancing productivity.

How It Works

The system operates by running each Claude Code instance within its own tmux session. recon then interfaces with tmux to list active sessions and panes, and it parses Claude Code's session metadata files (~/.claude/sessions/{PID}.json) and project logs to ascertain the status and details of each agent. Agent states (Working, Input, Idle, New) are determined by inspecting the text content of the Claude Code TUI status bar within each tmux pane.

Quick Start & Requirements

• Installation: Install via Cargo: cargo install --path .
• Prerequisites: Requires tmux and Claude Code.
• Documentation: Usage examples and keybindings are provided within the README.

Highlighted Details

• Offers two distinct dashboard views: a visual "Tamagotchi View" with pixel-art representations of agents and a functional "Table View" detailing session status, Git branches, and activity.
• Enables comprehensive session management, including launching new agents, resuming past sessions, switching between them, and terminating agents.
• Integrates deeply with tmux, allowing the dashboard to be launched as a popup overlay via custom keybindings (e.g., prefix + g).
• Provides real-time status updates by monitoring tmux pane status bars and session metadata files, avoiding reliance on process parsing.

Maintenance & Community

The project is not accepting pull requests but welcomes bug reports and feature requests via GitHub Issues. No community channels like Discord or Slack are specified.

Licensing & Compatibility

The project is released under the MIT license, which permits broad use, including commercial applications, with minimal restrictions.

Limitations & Caveats

A known limitation is that Claude Code's /clear command can lead to stale data in recon until the affected session is restarted, as it disrupts session tracking. The recommended workaround is to kill and recreate the session.