Session Restore

Restore saved session state after compaction using FOXCTL_SESSION_RESTORED.

3|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/joshka0/foxctl --skill session-restore-joshka0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Session Restore
Source: https://github.com/joshka0/foxctl/tree/main/configs/skills-condensed/session-restore
Command: npx skills add https://github.com/joshka0/foxctl --skill session-restore-joshka0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of losing task context after session compaction, so you can continue work without manually reconstructing prior state.

Core Features & Use Cases

  • Restores core session context: brings back the active plan title and sections, including the active task ID, pending todos, and captured gotchas & learnings.
  • Rehydrates summaries: restores the session summary so the next step has the right high-level intent.
  • Use case: after a long run is compacted, use this Skill to restore the exact plan and task state, then continue from where you left off.

Quick Start

Run session restore after compaction to reinject the restored markdown context back into your workflow.

Frequently Asked Questions about Session Restore

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

FAQPage Schema
How do I restore task context after a session compaction?

Restoring task context after session compaction requires injecting saved markdown context to reconstruct the active plan, task ID, pending todos, gotchas, and learnings for workflow continuation.

What is workflow continuity and when do I need markdown context recovery?

Workflow continuity is the ability to resume development tasks after a context window resets, requiring markdown context recovery to rehydrate the active plan title, sections, and session summary.

How do I resume active todos and gotchas after an AI agent restart?

To resume active todos and gotchas after an AI agent restart, set FOXCTL_SESSION_RESTORED=true and inject the prior markdown state to restore the exact task state for the next step.

Do I need to set environment variables for session restore?

Yes, session restore requires setting FOXCTL_SESSION_RESTORED=true to signal the downstream workflow steps that the markdown context has been successfully injected and reconstructed.

Can I use session restore to recover a high-level summary for AI agent orchestration?

Yes, session restore rehydrates the session summary to ensure the next step in AI agent orchestration maintains the correct high-level intent and continues from the exact prior state.

What's the best way to reconstruct a development plan after losing context?

The best way to reconstruct a development plan after losing context is using a session restore skill that applies markdown context injection to bring back the active plan title, sections, and todos.