Session List

Lists all Claude Code sessions for a project or globally, sorted by recency, size, or duration. Use when the user asks how many sessions they have, wants to see recent sessions, says "list sessions", or wants a session inventory.

apappascs Updated

File contents

Session List

List all sessions, optionally filtered by project and sorted.

Step 1: Run the listing script

bun run ${CLAUDE_PLUGIN_ROOT}/lib/session-store.ts list --limit 20

To filter by project:

bun run ${CLAUDE_PLUGIN_ROOT}/lib/session-store.ts list --project "<filter>" --limit 20

To sort by size or duration instead of recency:

bun run ${CLAUDE_PLUGIN_ROOT}/lib/session-store.ts list --sort size --limit 20

Step 2: Present results

The script outputs a JSON array. Present as a markdown table:

# Session ID Project Date Messages Duration Size

Highlight the current session if it matches the working directory. Show the resume command: claude --resume <session-id>.

If the user asks for more detail on a specific session, use /session-stats <session-id>.

apappascs/claude-code-sessions/tree/main/skills/session-list commit 07165be123

Frequently asked questions

npx skillmds@latest add apappascs/session-list