session-checkpoints

Save and restore session state in .opencastle/SESSION-CHECKPOINT.md files.

59|12|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/etylsarin/opencastle --skill session-checkpoints
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-checkpoints
Source: https://github.com/etylsarin/opencastle/tree/main/src/orchestrator/skills/session-checkpoints
Command: npx skills add https://github.com/etylsarin/opencastle --skill session-checkpoints

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a repeatable protocol to save and restore session state across multi-agent development sessions so interrupted work can be resumed, replayed, or forked without re-analyzing the entire codebase.

Core Features & Use Cases

  • Standardized checkpoint file: Maintains .opencastle/SESSION-CHECKPOINT.md with phase, completed work, in-progress tasks, delegation logs, approvals, and resume instructions.
  • Resume and recovery workflow: Verifies git state, tracker issues, and approvals before resuming to prevent drift and accidental deployment.
  • Delegation cost and audit: Tracks delegation cost, model tiers, and durations to optimize budgets and postmortems.
  • Use Case: After a long-running refactor or DB migration, developers restore the last checkpoint to continue phase-by-phase work and verify preconditions before risky operations.

Quick Start

Resume the current session by loading .opencastle/SESSION-CHECKPOINT.md, verify branch and tracker state, and follow the checkpoint's Resume Instructions.

Frequently Asked Questions about session-checkpoints

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

FAQPage Schema
How do I resume an interrupted agent session after a long-running task?

To save and restore session state, this Skill produces a standardized `.opencastle/SESSION-CHECKPOINT.md` file containing phase details, task tables, delegation logs, approvals, and resume instructions. It verifies git state and tracker issues before resuming to prevent drift across agent sessions.

How does session state management work for multi-agent development workflows?

Session state management for multi-agent workflows works by producing a standardized checkpoint file containing phase details, delegation logs, and approvals. It verifies git state and tracker issues before resuming to prevent drift and accidental deployment across interrupted development sessions.

What's the best way to track delegation cost and model tiers across agent sessions?

The best way to track delegation cost and model tiers is by maintaining a delegation log within the `.opencastle/SESSION-CHECKPOINT.md` file. This protocol audits delegation costs, model tiers, and durations to optimize budgets and facilitate postmortems for multi-session development workflows.

Can I fork an interrupted development phase without re-analyzing the entire codebase?

Yes, you can fork an interrupted development phase without re-analyzing the codebase by loading the standardized `.opencastle/SESSION-CHECKPOINT.md` file. This checkpoint protocol enables replay, fork, and resume of interrupted work by providing phase details, task tables, and step-by-step resume instructions.

When do I need a session checkpoint file for git workflow verification?

You need a session checkpoint file for git workflow verification when running multi-session development where agents decompose tasks and may be interrupted during delegation, verification, or long-running tasks. It verifies branch and tracker state before resuming risky operations like DB migrations to prevent accidental deployment.