Recoleta Item Note
Show HN: Recon – A tmux-native dashboard for managing Claude Code
Recon is a tmux-native terminal dashboard for centrally managing multiple Claude Code agent sessions, allowing users to view status, switch, create, terminate, and resume sessions without leaving the terminal. Its main…
code-intelligencemulti-agent-software-engineeringhuman-ai-interactionterminal-uitmux-tooling
Summary
Recon is a tmux-native terminal dashboard for centrally managing multiple Claude Code agent sessions, allowing users to view status, switch, create, terminate, and resume sessions without leaving the terminal. Its main value is improving visibility and operational efficiency in multi-agent coding workflows.
Problem
- When multiple Claude Code sessions run in parallel, it is difficult for users to quickly know what each agent is doing, whether it is stuck, and whether it needs human approval.
- Manually switching, finding, restoring, and managing multiple sessions in tmux is costly, especially in multi-repo, multi-task parallel development.
- Existing approaches often rely on
psparsing or working-directory heuristic matching, which can be inaccurate and undermine automation and stable management.
Approach
- Run each Claude Code instance in an independent tmux session, with Recon providing a unified TUI dashboard for centralized management.
- Precisely associate Claude processes with session IDs by reading
~/.claude/sessions/{PID}.json, avoiding the use ofpsor CWD heuristics. - Aggregate information such as session status, context usage, model, and recent activity time through
tmux list-panes,tmux capture-pane, and incremental parsing of~/.claude/projects/.../*.jsonl. - Use a status-bar detection mechanism to identify whether a session is
Input,Work,Idle, orNew, and display this in real time in both the table view and the Tamagotchi-style pixel creature view. - Provide commands such as
launch/new/resume --jsonand tmux popup shortcuts, so creating, restoring, jumping to, and scripting automation can all be handled from a single entry point.
Results
- The excerpt does not provide standard benchmarks, controlled experiments, or formal quantitative metrics, so there are no academic-style performance numbers to report.
- The system claims to support unified management of multiple Claude Code sessions, with a refresh frequency of polling every 2 seconds, and uses incremental JSONL parsing for real-time status updates.
- The interface can display specific context quota numbers, such as 45k/1M, 12k/200k, 90k/200k, helping users judge token usage.
- It supports room grouping by working directory using a 2×2 paginated grid; users can view, switch, terminate, create, and restore sessions within a single dashboard.
- It claims to handle multiple sessions in the same repository without conflicts, and supports
recon --jsonfor integration with scripts and automation workflows. - Compared with manual tmux management, its strongest specific improvement claim is that users can pop up the dashboard with a single hotkey, quickly identify which agents are working, sleeping, or waiting for approval, and jump directly to the corresponding session.
Link
Built with Recoleta
Run your own research radar
Turn arXiv, Hacker News, OpenReview, Hugging Face Daily Papers, and RSS into local Markdown, Obsidian notes, Telegram digests, and a public site.