recon

recon

A tmux-native dashboard for managing Claude Code agents.

Run multiple Claude Code sessions in tmux, then manage them all without ever leaving the terminal — see what each agent is working on, which ones need your attention, switch between them, kill or spawn new ones, and resume past sessions. All from a single keybinding.

Views

Tamagotchi View (recon view or press v)

A visual dashboard where each agent is a pixel-art creature living in a room. Designed for a side monitor — glance over and instantly see who's working, sleeping, or needs attention.

Creatures are rendered as colored pixel art using half-block characters. Working and Input creatures animate; Idle and New stay still.

- Rooms group agents by git repository — worktrees of the same repo share a room, while monorepo sub-projects get their own (e.g. myapp vs myapp › tools/cli) (2×2 grid, paginated)
- Zoom into a room with 1-4, page with j/k
- Context bar per agent with green/yellow/red coloring

Table View (default)

- Input rows are highlighted — these sessions are blocked waiting for your approval
- Working sessions are actively streaming or running tools
- Idle sessions are done and waiting for your next prompt
- New sessions haven't had any interaction yet

How it works

recon is built around tmux. Each Claude Code instance runs in its own tmux session.

Status detection inspects the Claude Code TUI status bar at the bottom of each tmux pane:

Session matching uses ~/.claude/sessions/{PID}.json files that Claude Code writes, linking each process to its session ID. No ps parsing or CWD-based heuristics.

Install

Requires tmux and Claude Code.

Usage

Keybindings — Table View

Keybindings — Tamagotchi View

Configuration

recon reads an optional config file from the platform config directory:

-…