List Sessions

Display recent Claude Code sessions for the current project (or all projects), showing size, age, and whether they can be resumed.

Usage

/list-sessions                  # List sessions for current project
/list-sessions --all            # List sessions across all projects
/list-sessions --limit 20       # Show only 20 most recent
/list-sessions --agents         # Include agent transcripts in listing

Arguments

Argument	Description	Default
--all	List sessions from all projects	false
--limit N	Maximum sessions to display	10
--agents	Include agent files in listing	false

Workflow

Step 1: Determine Target Directory

if ALL_PROJECTS; then
  TARGET_DIR="$HOME/.claude/projects"
else
  PROJECT_PATH=$(pwd | sed 's/[\/:]/-/g' | sed 's/^-//')
  TARGET_DIR="$HOME/.claude/projects/$PROJECT_PATH"
fi

Step 2: List Sessions

# Find session files (not agent files), sorted by modification time
find "$TARGET_DIR" -name "*.jsonl" ! -name "agent-*" -type f -printf '%T@ %s %p\n' 2>/dev/null | \
  sort -rn | head -$LIMIT | while read timestamp size path; do
    filename=$(basename "$path")
    age=$(( ($(date +%s) - ${timestamp%.*}) / 86400 ))
    size_h=$(numfmt --to=iec-i --suffix=B $size)
    echo "$filename  $size_h  ${age}d ago"
done

Step 3: Display Results

Recent Sessions
===============
Project: D--repos-gh-melodic-claude-code-plugins

 #  Session ID                              Size    Age     Resumable
--- --------------------------------------- ------- ------- ---------
 1  4165caab-4f86-4fc8-a901-fdcf2307a7cd   8.4M    today   Yes
 2  faf4b0f3-1f1f-438a-b40b-1a7ef4cb1718   7.9M    today   Yes
 3  55e42424-f5b6-4a26-98d5-1bed9176bf50   15M     1d      Yes
 4  336198a5-dfa4-4266-86dc-3d90158b8e30   15M     2d      Yes
 5  83d6bc93-3337-4b9e-8818-7141effbbcf0   14M     4d      Yes
...

Total: 507 sessions (645M)
Tip: Use /cleanup-sessions 7 to remove old sessions

Example Output

Recent Sessions
===============
Project: D--repos-gh-melodic-claude-code-plugins

 #  Session ID                              Size    Age
--- --------------------------------------- ------- -------
 1  4165caab-4f86-4fc8-a901-fdcf2307a7cd   8.4M    today
 2  faf4b0f3-1f1f-438a-b40b-1a7ef4cb1718   7.9M    today
 3  55e42424-f5b6-4a26-98d5-1bed9176bf50   15M     1d ago
 4  336198a5-dfa4-4266-86dc-3d90158b8e30   15M     2d ago
 5  83d6bc93-3337-4b9e-8818-7141effbbcf0   14M     4d ago
 6  0803ae22-fc67-4e53-abc2-1f82cda8a76d   10M     5d ago
 7  45e80d73-37fc-4968-ae22-afd826489252   7.0M    6d ago
 8  b514debc-f337-4c98-a516-78c18ea84352   6.8M    7d ago
 9  3a172514-ab79-481d-8883-5d2f4ec37d85   6.6M    8d ago
10  4eb06ac9-e6ef-4f5e-9735-38721722b7ae   6.5M    9d ago

Summary:
  Total sessions: 507
  Total size: 645M
  Oldest: 16 days ago

Tip: Resume a session with: claude --resume {session-id}
Tip: Clean old sessions with: /cleanup-sessions 7

Notes

• Sessions can be resumed using claude --resume {session-id}
• Session IDs are UUIDs assigned by Claude Code
• Large sessions (>10MB) indicate long conversations
• Use /session-stats for aggregate statistics