recon — Manage Claude Code agents effortlessly with a…

Pitch

Description

Comments

About this project

Recon is a tmux-native dashboard designed for managing Claude Code agents in an efficient manner. It allows users to run multiple sessions simultaneously, providing a visual overview of agent statuses and activities without leaving the terminal. Features include a Tamagotchi View for easy monitoring and seamless session management with just a keybinding.

recon is a tmux-native dashboard designed to efficiently manage Claude Code agents right from the terminal. This tool enables users to run multiple Claude Code sessions within tmux and oversee all activity without leaving the command line. Key functionalities include monitoring agent tasks, identifying those that require attention, and easily switching between various sessions. All of this is accessible through a single keybinding.

Features

Live Status Monitoring: Recon polls every 2 seconds for the current status of sessions, ensuring timely updates and accurate information.
Tamagotchi View: A visually engaging dashboard where each agent is represented as a unique pixel-art creature occupying a room, offering an at-a-glance overview of their status (working, idle, or needing attention).
Context Tracking: Detailed monitoring of token usage with real-time metrics such as used and available tokens (e.g., 45k/1M).
Model Display: Get insights on which Claude model is in use and the effort level being applied.
Session Management: Allows users to resume past sessions seamlessly, without any conflicts, with the option to view past sessions through an interactive picker.
JSON Mode: Enables automated scripting and custom configurations through JSON output.

Usage Examples

Terminal Commands

To launch the recon dashboard:

recon  # Launch the Table dashboard
recon view  # Switch to Tamagotchi visual dashboard
recon --json  # Output data in JSON format for scripting

Keybindings Overview

Table View Actions

Key	Action
`j/k`	Navigate between sessions
`Enter`	Switch to the selected tmux session
`v`	Change to Tamagotchi view
`r`	Refresh the session list
`q`	Exit the recon dashboard

Tamagotchi View Actions

Key	Action
`1-4`	Zoom into the respective room
`h/l`	Select agents when zoomed
`x`	Terminate the selected agent
`n`	Start a new session in the currently viewed room
`Esc`	Zoom out or quit

System Requirements

Recon operates within a tmux environment and requires integration with Claude Code for full functionality. This combination allows users to harness the power of both tools, providing a smooth workflow for managing multiple AI sessions. Detailed installation steps and configurations are provided in the repository for ease of setup.

By enhancing productivity and organization, recon serves as an essential tool for developers working with Claude Code, streamlining agent management directly from the terminal.