Skip to content
Development
Skill

/session-persist

Persist and restore agent sessions across conversations with state snapshots

From plugin
claude-flow
67k200 skills157 agents194 commands1 MCP
Install
$ npx -y skills add ruvnet/claude-flow --skill session-persist --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/session-persist

Context preview

The summary Claude sees to decide when to auto-load this skill.

Persist and restore agent sessions across conversations with state snapshots

SKILL.md

session-persist.SKILL.md
name: session-persist
description: Persist and restore agent sessions across conversations with state snapshots
argument-hint: "[--save|--restore|--list]"
allowed-tools: mcp__plugin_ruflo-core_ruflo__session_save mcp__plugin_ruflo-core_ruflo__session_restore mcp__plugin_ruflo-core_ruflo__session_list mcp__plugin_ruflo-core_ruflo__session_info mcp__plugin_ruflo-core_ruflo__session_delete mcp__plugin_ruflo-core_ruflo__hooks_session-start mcp__plugin_ruflo-core_ruflo__hooks_session-end mcp__plugin_ruflo-core_ruflo__hooks_session-restore Bash

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__plugin_ruflo-core_ruflo__session_save` to snapshot current state 2. **List sessions** — call `mcp__plugin_ruflo-core_ruflo__session_list` to see all saved sessions 3. **Restore** — call `mcp__plugin_ruflo-core_ruflo__session_restore` to resume a previous session 4. **Info** — call `mcp__plugin_ruflo-core_ruflo__session_info` for session details and metadata 5. **Clean up** — call `mcp__plugin_ruflo-core_ruflo__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
Read more
Ships withclaude-flow

An agent meta-harness for Claude Code and Codex. Agent = Model + Harness. The model writes; the harness gives it tools, memory, loops, sandboxes, and controls so it can actually work.

Get the whole plugin

Other skills on claude-flow.