claude-foundations/memory/script-claude-sessions.md

name, description, metadata

name	description	metadata
script-claude-sessions	claude-sessions — tmux session manager; interactive menu with folder picker, unique topic, and location column	type reference

claude-sessions

Python script (scripts/claude-sessions, symlinked to ~/sbin/). Manages Claude Code tmux sessions: list, recover, resume, spawn, gc. Run with no args for the interactive menu.

Menu behaviour (2026-10-26)

• Location column. Live and resumable rows show the session folder (~ for $HOME). Live rows take it from the registry (project_dir), falling back to tmux #{session_path}.
• n New session. Asks for a folder: Enter accepts the nearest CLAUDE.md folder, b opens the folder browser, or type a project name/path (same lookup as claude-tmux).
• Folder browser. zenity --file-selection --directory when DISPLAY/WAYLAND_DISPLAY is set and zenity exists (has Create Folder). Otherwise a terminal browser: number = open, u up, n new folder, /text filter, > < page, h hidden, ~//path jump, Enter/s select, q cancel.
• Topic. Becomes the tmux session name and the Remote Control name (passed as --name to claude-tmux). Defaults to the Title-Cased folder name. If that name is already a live tmux session, no default is offered and a unique topic is required. Topics containing . or : are rejected because tmux rewrites them to _.

Gotchas

• "In use" means a live tmux session. Resumable registry entries do not block a topic.
• claude-tmux still auto-appends #N on a collision, but the menu rejects collisions first.