claude-session-tools

claude-session-tools

Claude Code plugin for monitoring, summarizing, and interacting with running Claude Code tmux sessions.

Features

• spawn-session - Spawn new Claude Code sessions as subagent workers
• list-sessions - Show all running ai-* Claude Code sessions with status
• summarize-session - Get a detailed summary of what's happening in a session
• approve-action - Detect and handle permission prompts
• unstick-session - Diagnose and resolve stuck sessions

Installation

From GitHub (inside Claude Code)

/plugin marketplace add shsym/claude-session-tools
/plugin install session-tools@shsym-claude-session-tools

Usage

Spawn Session

Spawn a new Claude Code session as a subagent:

/session-tools:spawn-session worker api -- Implement the REST API

List Sessions

Show all running ai-* sessions:

/session-tools:list-sessions

Summarize Session

Get a summary of what's happening in a specific session:

/session-tools:summarize-session ai-worker-001

Approve Action

Handle permission prompts interactively:

/session-tools:approve-action ai-worker-002

Or approve/deny directly:

/session-tools:approve-action ai-worker-002 approve
/session-tools:approve-action ai-worker-002 deny

Unstick Session

Diagnose a stuck session:

/session-tools:unstick-session ai-worker-001

Diagnose and auto-fix:

/session-tools:unstick-session ai-worker-001 auto

Recognized Sessions

This plugin recognizes tmux sessions with ai- prefixes.

Requirements

• Claude Code
• tmux installed and accessible

Helper Scripts

Script	Purpose
spawn-session	Create new Claude Code tmux session
next-session-name	Generate next available session name
capture-session	Capture and clean tmux output
detect-state	Detect session state (working, idle, etc.)
detect-stuck-type	Identify specific stuck condition
send-unstick	Send keys to resolve stuck state
list-ai-sessions	List all ai-* sessions with state

Testing

E2E tests are in a separate repo: claude-session-tools-tests

License

MIT