session-bridge

Restore agent session context from plan file checkboxes.

25|7|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/xoai/sage --skill session-bridge-xoai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-bridge
Source: https://github.com/xoai/sage/tree/main/core/capabilities/context/session-bridge
Command: npx skills add https://github.com/xoai/sage --skill session-bridge-xoai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that your work progress is never lost, even if a session ends unexpectedly, by using the plan file as the definitive source of truth for task completion.

Core Features & Use Cases

  • State Persistence: Automatically saves and restores context across agent sessions.
  • Plan File as Ground Truth: Leverages task checkboxes in .sage/work/<feature>/plan.md to track progress accurately.
  • Use Case: If your agent crashes mid-task, upon restart, this Skill will read the plan file to know exactly which task was in progress and what has already been completed, allowing you to resume without manual intervention.

Quick Start

Use the session-bridge skill to resume your work from the last saved state.

Frequently Asked Questions about session-bridge

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

FAQPage Schema
How do I resume agent work after an unexpected session crash?

To preserve agent context across sessions, task progress is saved using a two-level state architecture. A ground truth plan file and a quick pointer file track completion, ensuring work is never lost and can be resumed seamlessly upon restart.

What is the best way to track task completion state for agent continuity?

The best way to track task completion for agent continuity is using plan file checkboxes as the definitive source of truth. Paired with a quick pointer file for progress tracking, this state architecture ensures reliable progress monitoring across interruptions.

Does session-bridge work without external dependencies for state management?

Yes, state management operates without external dependencies, relying entirely on internal files. It uses a ground truth plan file containing task checkboxes and a quick pointer file to preserve and restore agent session context natively.

When do I need to save context for agent session resumption?

You need to save context for session resumption when ending sessions gracefully or recovering from unexpected interruptions. Persisting state ensures that upon restart, the agent reads the plan file to know exactly which task was in progress and resume automatically.

Can I use plan file checkboxes to recover agent progress after an interruption?

Yes, plan file checkboxes are used as the ground truth to recover agent progress. By reading the checked tasks in the plan file, the session recovers exactly what has been completed and what was in progress, enabling seamless work resumption.