Skip to content

get_session_checkpoints

Returns all checkpoints for a session. Checkpoints are the richest source of context for resuming a session — each one contains a structured summary of what was accomplished, what changed, and what comes next.

Parameters

Parameter Type Required Description
sessionId string Yes The session GUID

Response

Returns a JSON array of checkpoint objects ordered by checkpointNumber:

[
  {
    "id": 42,
    "sessionId": "0c531e17-1fed-4bb0-a00e-e3e4a08ca6c4",
    "checkpointNumber": 3,
    "title": "Implemented JWT authentication",
    "overview": "Added JWT-based auth to the API...",
    "history": "Previous attempts used session cookies...",
    "workDone": "Created AuthController, JwtService...",
    "technicalDetails": "Using System.IdentityModel.Tokens.Jwt 7.x...",
    "importantFiles": "src/Auth/JwtService.cs, src/Auth/AuthController.cs",
    "nextSteps": "Add refresh token endpoint...",
    "createdAt": "2026-02-28T16:00:00Z"
  }
]

Checkpoint Sections

Field Content
title Short title for the checkpoint
overview High-level summary of the session state
history What was tried before, design decisions
workDone Specific files and changes made
technicalDetails Architecture notes, package versions, constraints
importantFiles Key files changed or referenced
nextSteps Planned work when the checkpoint was saved

Example Prompts

  • "Show all checkpoints for session 0c531e17..."
  • "What were the next steps in session abc123? Show me its checkpoints."
  • "Get the checkpoint history for this session so I can resume it"

Notes

Read the last checkpoint (highest checkpointNumber) to quickly restore the most recent context before resuming a session.