Task Continuity

Task continuity lets you save your work-in-progress state and pick it up later — even days later, in a completely new session. It’s like a bookmark for your AI’s working context.

When to Use Tasks

• End of a session when work is unfinished
• After completing a significant milestone
• Before switching to a different project
• When the user asks to pause or continue later

Checkpointing a Task

Save the current state with checkpoint:

{
  "tool": "checkpoint",
  "title": "Implement user authentication",
  "plan": "1. [x] Set up JWT middleware\n2. [x] Create login endpoint\n3. [ ] Add refresh token rotation\n4. [ ] Write integration tests",
  "progress": "Login endpoint working. Refresh tokens next.",
  "context": "Files: src/auth/middleware.ts, src/routes/login.ts. Using jsonwebtoken library. Decision: httpOnly cookies for refresh tokens.",
  "project": "my-project",
  "status": "paused"
}

Resuming a Task

At the start of a new session, check for active tasks:

{
  "tool": "list_tasks",
  "project": "my-project"
}

Then resume where you left off:

{
  "tool": "resume",
  "id": 3
}

The AI gets back the full plan, progress, and context — and can continue working immediately.

Best Practices

• Keep plan structured with numbered steps and checkboxes
• Update progress with what’s done and what’s next
• Put file paths, key decisions, and blockers in context
• Mark tasks completed when done, paused when shelving