Skip to content

list_recent_sessions

Returns the most recently updated Copilot CLI sessions from your local session-store.db. This is the fastest starting point after a machine restart when you need to find which session to resume.

Parameters

Parameter Type Required Default Description
limit integer No 20 Maximum number of sessions to return

Response

Returns a JSON array of session summary objects:

[
  {
    "id": "0c531e17-1fed-4bb0-a00e-e3e4a08ca6c4",
    "cwd": "C:\\dev\\nexus-labs\\needlr",
    "repository": "nexus-labs/needlr",
    "branch": "main",
    "summary": "Explore Microsoft Agent Framework Integration",
    "createdAt": "2026-02-15T10:30:00Z",
    "updatedAt": "2026-02-28T18:45:00Z",
    "turnCount": 87,
    "checkpointCount": 66
  }
]

Example Prompts

  • "List my most recent Copilot sessions"
  • "What sessions was I working on recently? Show the last 5."
  • "Which session was I using yesterday? Show me the 10 most recent."
  • "Find my most recent sessions and tell me which ones have the most turns"

Notes

Results are ordered by updatedAt descending — the most recently active session appears first. Use get_session_checkpoints after identifying a session to restore context from the last checkpoint.