checkpoint

Save and resume git working state with branch, status, diffs, and decisions.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/yckkkk/reo --skill checkpoint-yckkkk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint
Source: https://github.com/yckkkk/reo/tree/main/.agents/skills/checkpoint
Command: npx skills add https://github.com/yckkkk/reo --skill checkpoint-yckkkk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Checkpoint saves and resumes your working state by capturing git state, ongoing decisions, and remaining work so you can pick up exactly where you left off, even across branches and workspaces.

Core Features & Use Cases

  • Save and resume checkpoints for sessions, branches, and tasks.
  • Automatically capture repo state (branch, status, diffs) and a snapshot of decisions.
  • List, view, and restore checkpoints to restore context quickly.

Quick Start

Save your current state with /checkpoint, then resume wherever you left off with /checkpoint resume.

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?

You can save your git working state by running /checkpoint, which records your branch, status, diffs, and decisions. This allows you to safely pause work and switch branches without losing your current context.

What is the best way to resume a git task after pausing work?

The best way to resume a paused git task is by running /checkpoint resume. This restores your previously saved branch, diffs, and decision narrative, allowing you to pick up exactly where you left off across branches and workspaces.

Can I list and view saved git sessions to restore context?

Yes, you can list and view saved git sessions to restore context. The Skill exposes commands to list, view, and restore checkpoints, helping you quickly find and reload the exact branch state and decisions for your task.

Does the checkpoint workflow require a specific environment to store sessions?

The checkpoint workflow coordinates with the gstack environment to store sessions. It emits checkpoints and saves them under the ~/.gstack/projects/$SLUG directory, requiring this environment to manage your saved working states.

How does saving a git checkpoint help when switching tasks?

Saving a git checkpoint captures your repo state and a snapshot of remaining work and decisions. When switching tasks, this mechanism ensures you do not lose context, enabling a seamless transition back to your original branch later.

What limitations exist when moving saved git states across workspaces?

When moving saved git states across workspaces, checkpoints are stored under a specific ~/.gstack/projects/$SLUG directory. This means your ability to resume work depends on accessing this gstack environment storage to retrieve the saved branch and diffs.