checkpoint

Save and resume Git working state with branch, status, diffs, and logs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gfires/motion-analysis --skill checkpoint-gfires
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint
Source: https://github.com/gfires/motion-analysis/tree/main/checkpoint
Command: npx skills add https://github.com/gfires/motion-analysis --skill checkpoint-gfires

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Save and resume your working state across Git workspaces, so you can switch branches or contexts without losing track of what you were doing.

Core Features & Use Cases

  • Saves current git state, branch, status, diffs, and recent logs into a dedicated checkpoint file.
  • Resumes from the most recent or a chosen checkpoint, restoring context like working directory, decisions, and remaining tasks.
  • Generates a readable summary of what was done and what remains to be done to continue seamlessly.

Quick Start

Use /checkpoint save to create a checkpoint and /checkpoint resume to restore your work.

Frequently Asked Questions about checkpoint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save my git working state before switching branches?

To save your git working state, use the /checkpoint save command. It records your current branch, status, diffs, and recent logs into a dedicated checkpoint file, allowing you to safely switch contexts without losing track of your progress.

How do I resume work from a previous git checkpoint?

You can resume work from a previous git checkpoint by using the /checkpoint resume command. This restores your context, including the working directory, decisions, and remaining tasks, from the most recent or a specifically chosen checkpoint.

What information is captured when saving a git workspace context?

Saving a git workspace context captures your current branch, working status, file diffs, and recent commit logs. It also generates a readable summary of completed work and remaining tasks to help you continue seamlessly.

Can I add a custom title when saving a git session checkpoint?

Yes, you can add an optional title when saving a git session checkpoint. This helps you identify specific work states and choose the correct checkpoint to resume from when you return to that project context.

Where are git workspace checkpoint files stored on my local machine?

Git workspace checkpoint files are stored locally under the ~/.gstack/projects/${SLUG}/checkpoints directory. This integrates with the gstack workflow for session duration tracking and local telemetry data.