codemap_session_list
List archived session summaries with pagination. Shows session ID, start date, duration, and summary text for all closed sessions.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | number | ❌ Optional | Page number (default: 1, minimum: 1) |
pageSize | number | ❌ Optional | Sessions per page (default: 10, max: 50) |
Usage Examples
MCP Usage (for AI Agents like Claude)
json
{
"name": "codemap_session_list",
"arguments": {
}
}Example Output
JSON Response
json
{
"success": true,
"sessions": [
{
"sessionId": "2026-04-08T14-23-45",
"startedAt": "2026-04-08T14:23:45.123Z",
"closedAt": "2026-04-08T16:38:12.456Z",
"duration": "2 hours, 15 minutes",
"summary": "Implemented user authentication system with JWT tokens"
},
{
"sessionId": "2026-04-07T09-15-22",
"startedAt": "2026-04-07T09:15:22.789Z",
"closedAt": "2026-04-07T12:30:45.123Z",
"duration": "3 hours, 15 minutes",
"summary": "Fixed payment processing bug in checkout flow"
},
{
"sessionId": "2026-04-06T14-52-10",
"startedAt": "2026-04-06T14:52:10.456Z",
"closedAt": "2026-04-06T18:20:33.789Z",
"duration": "3 hours, 28 minutes",
"summary": "Refactored database layer and added caching"
}
],
"pagination": {
"page": 1,
"pageSize": 10,
"total": 15,
"totalPages": 2,
"hasMore": true
}
}When to Use This Tool
-
Use
- Browse session history
- Find a specific session to reopen
- Review past work summaries
- Audit project activity over time
- Generate reports on development history
codemap_session_list when you need to:
Pro Tips
- Default page size is reasonable: 10 sessions per page is usually enough for browsing
- Max page size is 50: If you need all sessions, paginate with pageSize=50
- Sessions ordered newest first: Most recent sessions appear on page 1
- Check hasMore for pagination: Use
pagination.hasMoreto know if more pages exist - Summaries are searchable: Filter sessions by checking summary text
- Session IDs are timestamps: Format is YYYY-MM-DDTHH-MM-SS (sortable)
Best Practices
- Use list to find sessions before reopening - don't guess session IDs
- Review summaries to identify the session you want
- For long project histories, paginate rather than retrieving all at once
- Combine with
codemap_session_readto get full details before reopening
Common Mistakes
❌ Mistake: Requesting huge page sizes unnecessarily
✅ Instead: Use default page size (10) for browsing, 50 only when needed
❌ Mistake: Not checking
✅ Instead: Check
❌ Mistake: Assuming page 1 always has sessions
✅ Instead: Check
❌ Mistake: Trying to reopen sessions without checking if they exist
✅ Instead: List first, verify session exists, then reopen
✅ Instead: Use default page size (10) for browsing, 50 only when needed
❌ Mistake: Not checking
hasMore when paginating✅ Instead: Check
pagination.hasMore to know when to stop❌ Mistake: Assuming page 1 always has sessions
✅ Instead: Check
pagination.total - might be 0 if no closed sessions❌ Mistake: Trying to reopen sessions without checking if they exist
✅ Instead: List first, verify session exists, then reopen