Skip to main content
AI/MLruvnet

session-persist

Persist and restore agent sessions across conversations with state snapshots

Stars
56,726
Source
ruvnet/claude-flow
Updated
2026-05-31
Slug
ruvnet--claude-flow--session-persist
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/ruvnet/claude-flow/HEAD/plugins/ruflo-rvf/skills/session-persist/SKILL.md -o .claude/skills/session-persist.md

Drops the SKILL.md into .claude/skills/session-persist.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Session Persistence

Save and restore complete agent sessions across conversations.

When to use

When you need to pause work and resume later with full context, or when you want to checkpoint progress during long-running tasks.

Steps

  1. Save session — call mcp__claude-flow__session_save to snapshot current state
  2. List sessions — call mcp__claude-flow__session_list to see all saved sessions
  3. Restore — call mcp__claude-flow__session_restore to resume a previous session
  4. Info — call mcp__claude-flow__session_info for session details and metadata
  5. Clean up — call mcp__claude-flow__session_delete to remove old sessions

Session hooks

  • hooks_session-start — automatically restore context at conversation start
  • hooks_session-end — automatically save state with metrics export
  • hooks_session-restore — restore a specific session by ID

What's persisted

  • Agent state and configuration
  • Memory entries and patterns
  • Learning trajectories and metrics
  • Task progress and todos