session-list

SkillCommunication

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

Use session-list in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add session-list and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the session-list skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

session-listStart free

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
66
Forks
12
Last commit
Sep 2026
Advanced
Item type
skill
Key
session-list
Source
github.com/the-agency-ai/the-agency