session-persist
Persist and restore agent sessions across conversations with state snapshots
Best for long-running tasksWorks with GitHubLow risk
⌘source
- author
@ruvnet- repo
- ruvnet/ruflo
- language
- TypeScript
★46kstars
5.1kforks
May 5, 2026
✦overview.md
Key Features
- ·Save full session state as snapshots
- ·Restore sessions across conversations
- ·List, inspect, and delete saved sessions
- ·Automatic hooks for start and end
- ·Persists agent state, memory, and metrics
Use Cases
- →Pause a long debugging task and resume later with full context
- →Checkpoint progress during complex refactoring
- →Switch between multiple parallel development streams
Best for
- ✓long-running tasks
- ✓work-in-progress preservation
Not ideal for
- !stateless operations
- !quick one-off queries
FAQs
name
session-persist
description
Persist and restore agent sessions across conversations with state snapshots
argument-hint:[--save|--restore|--list]
allowed-tools:mcp__claude-flow__session_save mcp__claude-flow__session_restore mcp__claude-flow__session_list mcp__claude-flow__session_info mcp__claude-flow__session_delete mcp__claude-flow__hooks_session-start mcp__claude-flow__hooks_session-end mcp__claude-flow__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
- Save session — call
mcp__claude-flow__session_saveto snapshot current state - List sessions — call
mcp__claude-flow__session_listto see all saved sessions - Restore — call
mcp__claude-flow__session_restoreto resume a previous session - Info — call
mcp__claude-flow__session_infofor session details and metadata - Clean up — call
mcp__claude-flow__session_deleteto remove old sessions
Session hooks
hooks_session-start— automatically restore context at conversation starthooks_session-end— automatically save state with metrics exporthooks_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
$install
1-click copynpx skills add ruvnet/ruflo --skill session-persistSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.