session-list

Lists and filters Claude Code sessions by date, branch, directory, size, and initial message.

39|6|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/the-agency-ai/the-agency --skill session-list-the-agency-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-list
Source: https://github.com/the-agency-ai/the-agency/tree/main/.claude/skills/session-list
Command: npx skills add https://github.com/the-agency-ai/the-agency --skill session-list-the-agency-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users list and review historical Claude Code sessions efficiently, saving time in tracking project activity.

Core Features & Use Cases

  • Session Metadata Compilation: Retrieves session details such as date, branch, directory, size, and initial message.
  • Filtering Options: Allows filtering sessions by branch or date for targeted review.
  • Use Case: A developer wants to find the last session on a specific feature branch to review its initial discussion points and timestamps.

Quick Start

Use the session list skill to display all recent sessions and locate a specific session ID for detailed inspection.

Frequently Asked Questions about session-list

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list past Claude Code sessions for project review?

You can list past Claude Code sessions by reading session JSONL files and extracting embedded message metadata, which compiles details like date, branch, directory, size, and initial message for display. This provides a quick overview of historical project activity.

Can I filter Claude Code session histories by branch or date?

Yes, you can filter Claude Code session histories by specific branches or dates. This allows for targeted review of past sessions, making it easier to locate specific session IDs and track discussions across different feature branches.

What metadata is available when reviewing historical Claude Code sessions?

When reviewing historical Claude Code sessions, the available metadata includes the session date, branch, directory, file size, and the initial message. This information is extracted from embedded messages within session JSONL files.

How do I find the initial discussion points from a specific feature branch session?

To find initial discussion points from a specific feature branch, you can list and filter past sessions by branch to locate the relevant session ID. The extracted metadata will display the initial message and timestamps for detailed inspection.

Do I need to manually parse JSONL files to track Claude Code project activity?

No, you do not need to manually parse JSONL files to track project activity. This process automatically reads session JSONL files and extracts the embedded message metadata, saving time by compiling session details like directory and size for you.