List Claude Code Sessions

VerifiedSafe

Lists all running tmux sessions with names starting with 'ai-' and displays their current status (working, idle, permission-prompt, waiting-input, stuck). Useful for monitoring multiple Claude Code sessions in a tmux environment to quickly see which sessions are active or need attention.

Sby Skills Guide Bot
DevelopmentIntermediate
1006/2/2026
Claude Code
#tmux#session-management#claude-code#workflow#monitoring

Recommended for

Our review

Lists all running ai-* tmux sessions with their current status.

Strengths

  • Provides a quick overview of all AI session states.
  • Clear status classification (working, idle, permission-prompt, etc.).
  • Non-intrusive: does not interfere with running sessions.

Limitations

  • Requires sessions to be named with the 'ai-' prefix.
  • Works only with tmux, not other terminal multiplexers.
  • May miss some complex states (e.g., blocked subprocesses).
When to use it

When managing multiple Claude Code sessions and need a quick status overview.

When not to use it

If using a different session manager or sessions lack the 'ai-' prefix.

Security analysis

Safe
Quality score90/100

The skill only lists and inspects local tmux sessions; it does not perform any destructive, exfiltrating, or obfuscated actions. The commands are straightforward and benign.

No concerns found

Examples

List all sessions
List all running ai-* tmux sessions with their status.
Check session status
Show me the status of all Claude Code sessions right now.

name: list-sessions description: List all running ai-* Claude Code tmux sessions with their current status

List Claude Code Sessions

List all running ai-* prefixed tmux sessions and show their current status.

Instructions

  1. Get all ai- sessions:*

    tmux list-sessions -F "#{session_name}" 2>/dev/null | grep -E '^ai-' || echo ""
    
  2. For each session, capture recent output:

    "$PLUGIN_DIR/bin/capture-session" "<session_name>" 15
    
  3. Analyze each session's output to determine status:

    • working - Has , , or Thinking…
    • idle - At prompt with no activity
    • permission-prompt - Waiting for permission approval
    • waiting-input - Waiting for user input (y/n, choice, text)
    • stuck - In editor, pager, or hanging
  4. Output a table:

    Session                Status              Details
    ───────────────────────────────────────────────────
    ai-worker-001          working             Editing src/api.ts
    ai-worker-002          permission-prompt   Bash: npm install
    ai-brainstorm-design   idle                At prompt
    
  5. If no sessions found:

    No ai-* sessions found.
    
    To create one: /session-tools:spawn-session worker
    
Related skills