
Session Persist
- 678 installs
- 67k repo stars
- Updated August 4, 2026
- ruvnet/ruflo
session-persist is an agent memory skill that saves and restores complete AI coding agent sessions with state snapshots across conversations using claude-flow MCP session tools.
About
session-persist is a skill from ruvnet/ruflo that persists and restores agent sessions across conversations via claude-flow MCP tools including session_save, session_restore, session_list, session_info, session_delete, and session hooks. It supports CLI-style arguments `--save`, `--restore`, and `--list` for checkpointing long-running implementation work and resuming with full context later. Allowed tools span mcp__claude-flow__ session operations plus Bash for orchestration. Developers reach for session-persist when multi-hour refactors or investigations must pause without losing tool results, decisions, or partial edits, and when they want durable checkpoints during lengthy agent-driven builds.
- Maintains persistent session state for Claude, Cursor and other agents
- Prevents context loss during long-running development tasks
- Enables memory across separate chat threads and tool calls
- Reduces token waste from repeated context re-injection
- Works with ruvnet/ruflo MCP server architecture
Session Persist by the numbers
- 678 all-time installs (skills.sh)
- +10 installs in the week ending Jul 26, 2026 (Skillselion tracking)
- Ranked #1,438 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ruvnet/ruflo --skill session-persistAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 678 |
|---|---|
| repo stars | ★ 67k |
| Last updated | August 4, 2026 |
| Repository | ruvnet/ruflo ↗ |
How do you persist agent sessions across conversations?
So their AI coding agent can maintain memory, context, and state across long conversations and multiple sessions.
Who is it for?
Developers running long Claude-flow agent tasks who must pause and resume with full session context intact across separate conversations.
Skip if: Ephemeral one-shot prompts or teams without claude-flow MCP session tools configured in their agent environment.
When should I use this skill?
A long agent task must pause and resume later without losing prior tool outputs, decisions, or partial implementation state.
What you get
Saved session snapshots, restored conversation state, and session_list metadata for multi-day agent workflows.
Files
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 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
Related skills
FAQ
Which MCP tools does session-persist use?
session-persist uses claude-flow MCP tools including session_save, session_restore, session_list, session_info, session_delete, plus session-start, session-end, and session-restore hooks for automated persistence.
How do you invoke session-persist from the CLI?
session-persist accepts argument-hint flags --save, --restore, and --list to checkpoint an active agent session, reload a prior snapshot, or enumerate stored sessions without manual MCP calls.