craftzdog/tmux-claude-session-manager

Run many Claude Code sessions across your projects, each in its own tmux session — then list them, see which are done vs. still working, and jump to one from a single popup.

What it solves

This project provides a way to manage multiple concurrent Claude Code sessions across different projects. It eliminates the need to manually track which AI agents are still working, which are idle, or where they are located across various tmux sessions, allowing users to jump between them quickly from a single interface.

How it works

  • Session Tracking: It uses claude agents --json as the source of truth to identify running agents and their current status (working, waiting, or idle).
  • Process Mapping: The tool pairs each Claude process with its corresponding tmux pane by mapping the process ID (PID) to the TTY and then to the pane.
  • Navigation: A central picker (powered by fzf) provides a live preview of each agent's screen using capture-pane. Users can jump to a specific agent, launch new sessions for the current directory, or kill finished agents directly from the picker.
  • Integration: It integrates as a tmux plugin, utilizing display-popup for a seamless overlay experience.

Who it’s for

Developers using Claude Code who run multiple AI agents across various directories and want a centralized way to monitor and monitor and jump between them within tmux.

Highlights

  • Live Status Monitoring: Instantly see if an agent is working, waiting, or idle without opening the session.
  • Centralized Picker: A single popup interface to list, filter, and jump to any running Claude agent.
  • Lvie Preview: Real-time screen capture of the agent's current output in the picker.
  • Smart Jump: Automatically switches to the original window where the session was launched and resumes the agent in a popup.
  • Quick Launcher: Rapidly start or re-attach to a Claude session for the current directory with a single keybinding.

Related

  • Project
    hiroppy/tmux-agent-sidebar

    A tmux plugin that provides a centralized sidebar to monitor and manage AI coding agents like Claude Code, Codex, and OpenCode across all sessions and windows.

  • Project
    amirlehmam/wmux

    A visibility layer for AI coding agents on Windows that provides a centralized dashboard to monitor, navigate, and interact with multiple parallel agent sessions.

  • Project
    T1mn/pad

    A tmux-native TUI workspace for managing multiple terminal AI agents, allowing users to preview conversation history and jump between sessions quickly.

  • Project
    gbasin/agentboard

    A web GUI for tmux optimized for AI agent TUIs, enabling remote and mobile access to agent sessions with status tracking and specialized mobile controls.

  • Project
    jarrodwatts/claude-hud

    A Claude Code plugin that adds a real-time status line to the terminal, providing visibility into context usage, tool activity, and agent progress.