save_checkpoint
Save a progress checkpoint after each concrete sub-task. Future agent sessions resume exactly from this point, avoiding redoing completed work.
Instructions
Save a progress checkpoint so any future agent session can resume exactly here.
Call this after EVERY concrete sub-task (a file edited, a test passing, a command run) — not only when a numbered step finishes. Frequent, small checkpoints are the point: if the session dies mid-step, the next agent resumes from the last sub-task instead of redoing the whole step.
Args: plan: The full numbered plan being executed (all steps, verbatim). current_step: 1-based number of the step currently being worked on. total_steps: Total number of steps in the plan. step_status: "in_progress", "done", or "blocked" — status of current_step. what_was_done: Everything completed so far, across all steps, specific enough that another agent will not redo any of it. what_remains: What is still missing IN THE CURRENT STEP, specific enough to be the very next action (plus any known remaining steps). project_dir: Optional project directory override; defaults to the server's working directory (walking up to the nearest .git root).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan | Yes | ||
| project_dir | No | ||
| step_status | Yes | ||
| total_steps | Yes | ||
| current_step | Yes | ||
| what_remains | Yes | ||
| what_was_done | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |