checkpoint

Save the current state of an in-progress task so it can be resumed later. Tasks persist across sessions and can be listed and restored.

Parameters

Parameter	Type	Required	Description
title	string	Yes	Descriptive task title
plan	string	No	Structured plan (numbered steps, checkboxes)
progress	string	No	What’s done and what’s next
context	string	No	File paths, decisions, blockers
project	string	No	Project scope
status	string	No	”active” or “paused” (default: “active”)

Return Value

Returns the task ID ([task:N]).

Examples

Checkpoint a feature

{
  "title": "Implement refresh token rotation",
  "plan": "1. [x] Add token rotation endpoint\n2. [ ] Update client-side logic\n3. [ ] Write tests",
  "progress": "Server endpoint done. Client next.",
  "context": "Files: src/auth/refresh.ts. Using jose library for JWT.",
  "project": "my-project",
  "status": "paused"
}

Related Tools

• resume — Restore a checkpointed task
• list_tasks — List all tasks