skills.rest
ruvnet
ruvnetCOMMUNITY
Explore all skills by this author →
Website𝕏@ruvGitHub

session-persist

Save and restore agent session state snapshots across conversations.

70.1k|8.4k|Updated Jun 2, 2025
Search Tags:#agent memory#Hooks#session persistence#context restore#state snapshot#workflow checkpoint#MCP Tools
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill session-persist
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-persist
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-rvf/skills/session-persist
Command: npx skills add https://github.com/ruvnet/claude-flow --skill session-persist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long-running agent tasks lose all context when a conversation ends, forcing you to rebuild state, memory, and progress from scratch. This Skill snapshots agent sessions so work can be paused and resumed later with full context intact.

Core Features & Use Cases

  • Session Snapshots: Save the complete agent state, including memory entries, learning trajectories, metrics, and task progress, via the session_save tool.
  • Session Restoration: List, inspect, and restore previous sessions by ID to resume work exactly where it stopped.
  • Lifecycle Hooks: Automatically save state at conversation end and restore context at conversation start using session-start, session-end, and session-restore hooks.
  • Use Case: During a multi-day refactoring project, checkpoint progress each evening with a session save, then restore the snapshot the next morning to continue with all todos, memory, and metrics preserved.

Quick Start

Ask the agent to save the current session state, then later request it to list saved sessions and restore the one you want to resume.

Frequently Asked Questions about session-persist

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

FAQPage Schema
How do I save and restore an agent session across conversations?▼

Call the session_save tool to snapshot the current state, then use session_list to view saved sessions and session_restore to resume one. Session hooks can also automate saving at conversation end and restoring at start.

What data is included in a session snapshot?▼

A snapshot persists agent state and configuration, memory entries and patterns, learning trajectories and metrics, and task progress with todos. This allows full context recovery when the session is restored.

Can sessions be restored automatically when a conversation starts?▼

Yes, the hooks_session-start tool automatically restores context at conversation start, while hooks_session-end saves state with metrics export. A specific session can also be restored by ID using hooks_session-restore.

How do I clean up old saved sessions?▼

Use the session_list tool to review all saved sessions, then call session_delete with the session ID to remove ones you no longer need. The session_info tool shows details and metadata before deletion.

When should I not rely on session persistence?▼

Session persistence is designed for pausing and resuming agent work, not as a general backup or version control system. For short single-conversation tasks, the snapshot overhead provides no benefit.

Related Skills

Explore More Software Engineering Skills→
tony30552001tony30552001

setup-gbrain

Install gbrain CLI and initialize a local brain for Claude Code memory.

Community
Advanced
tDaliletDalile

gsd:reference:continuation-format

Define a standardized continuation format for resuming GSD session state.

Community
Basic
pskoettpskoett
273

self-improvement

Log errors, corrections, and knowledge gaps during AI agent execution.

Community
Advanced
redisredis
30

codex-settings-sync

Migrates Codex state from ~/.codex to a Redis-backed Agent Filesystem workspace.

Official
Intermediate