craftzdog

Tmux Claude Session Manager — Development skill for Claude Code

Development community

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.

How to install Tmux Claude Session Manager

This entry records only its repository, not the path inside it, so there is no exact command to give. Open craftzdog/tmux-claude-session-manager and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tmux Claude Session Manager does

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.

Alternatives in Development

Tentacle Context Init — You are working on the {{tentacleName}} section 1.4k ★
Cavemem — Frozen — cross-agent persistent memory for coding assistants 674 ★
CoderBar — Native macOS agent control for Codex and Claude — monitor, approve, ask, and jump back from the menu bar 100 ★

README

tmux-claude-session-manager

[![screenshot](./docs/screenshot.jpg)](https://youtu.be/NnTV6r4l5D0)

Run many [Claude Code](https://claude.com/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.

If you launch Claude per-directory (one nested session per project), you quickly end up with a dozen of them and no way to tell which are finished without opening each one. This plugin gives you:

🔢 A central picker (prefix + u) listing every running Claude agent — several in one project, and any running loose in an ordinary pane.
🟢 Live status per agent — working / waiting / idle — read straight from claude agents --json, so you instantly see which need you. No setup.
👁️ A live preview of each agent's screen right in the picker.
🎯 Smart jump — selecting an agent switches your client to the window it was launched from, then resumes it in a popup over it.
🚀 A launcher (prefix + y) that opens/attaches a Claude session for the current directory.
❌ Quick kill (ctrl-x) of a finished agent from the picker.
🔔 Bell forwarding — a bell in a dedicated session highlights the window you launched it from, so you notice even without opening the picker (one-time Claude Code setup).

Status needs no configuration. Claude Code publishes each agent's own state and the picker reads it — there are no hooks to install.

Prerequisites

tmux ≥ 3.2 (for display-popup)
fzf — the picker UI
jq — parses claude agents --json
Claude Code ≥ 2.1.139 — for the claude agents command (claude --version to check)
bash; macOS or Linux

Install (tpm)

Add to `~/.tmux.conf` (or `~/.config/tmux/tmux.conf`):

set -g @plugin 'craftzdog/tmux-claude-sessi