/session-list Command

List all development sessions with filtering and search capabilities.

Usage

# List all sessions
/session-list

# List last 10 sessions
/session-list --limit 10

# List active sessions
/session-list --status active

# List completed sessions
/session-list --status completed

# List sessions by date range
/session-list --start "2026-01-01" --end "2026-01-31"

# Search sessions
/session-list --search authentication
/session-list --search "user auth"

Arguments

| Argument | Type | Required | Description | Default | |---------|------|----------|-------------| | --status | string | No | Filter by status (todo, in-progress, completed, blocked, cancelled) | All | | --limit | number | No | Limit number of results | All | | --start | string | No | Filter by start date (YYYY-MM-DD) | All | | --end | string | No | Filter by end date (YYYY-MM-DD) | All | | --search | string | No | Search by name, goals, or notes | All |

Output Format

/session-list

# Output:
ID: 20260102-1430-auth-refactor
Name: Authentication Refactor
Status: completed
Start: 1/2/2026, 2:30:00 PM
Duration: 2h 30m
Branch: feature/auth
Commits: 5
Goals: 3/3 completed
----------------------------------------
ID: 20260103-1000-user-profiles
Name: User Profiles Feature
Status: in-progress
Start: 1/3/2026, 10:00:00 AM
Duration: 4h 15m (ongoing)
Branch: feature/users
Commits: 8
Goals: 2/5 completed
----------------------------------------
...

Session States

Status	Description	Typical Duration
`active`	Currently in progress	2-4 hours
`ended`	Completed	1-4 hours typical
`blocked`	Blocked on dependency	Variable
`cancelled`	Cancelled	N/A

Filtering Examples

By Status

# List only completed sessions
/session-list --status completed

# List active sessions
/session-list --status active

# List blocked sessions
/session-list --status blocked

By Date Range

# List sessions from January 2026
/session-list --start "2026-01-01" --end "2026-01-31"

# List last week
/session-list --start "2026-01-27" --end "2026-02-02"

By Search

# Search for authentication sessions
/session-list --search authentication

# Search for specific goal
/session-list --search "JWT tokens"

Best Practices

Session Management

✅ DO:

Use descriptive session names
Set clear, achievable goals
Add progress notes regularly
End sessions when goals complete
Review session history regularly

❌ DON'T:

Create overlapping sessions (same time period, similar work)
Leave sessions in active state indefinitely
Skip ending sessions with summary
Create sessions without clear purpose

Session Tracking