session-list

SkillCommunication

List past Claude Code sessions with metadata (date, branch, directory, size, first message)

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the session-list skill

What this skill tells your AI

The instructions your AI receives, as published by the-agency-ai/the-agency in .claude/skills/session-list/SKILL.md and read by ahel’s review.

Session List

List all Claude Code sessions for this project with metadata.

Arguments

  • --branch <pattern> — filter to sessions on a specific branch
  • --since YYYY-MM-DD — only show sessions after this date
  • No arguments shows all sessions, newest first

Steps

  1. Find session files: Glob ~/.claude/projects/*/*.jsonl (exclude subagent files).

  2. Extract metadata from each file's first user message line:

    • Timestamp, cwd, gitBranch, sessionId
    • First message content (truncate to 80 chars)
    • File size
  3. Filter by --branch or --since if specified.

  4. Display as table sorted by date (newest first):

    | Date       | Branch              | Directory                    | Size  | First Message          | Session ID |
    |------------|---------------------|------------------------------|-------|------------------------|------------|
    | 2026-03-20 | proto/proto-tooling | .worktrees/proto-tooling/    | 3.5MB | resume                 | abc123...  |
    
  5. Show the session ID so the user can pass it to /session-read.

Signals

GitHub stars
55
Forks
8
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
session-list
Source
github.com/the-agency-ai/the-agency