ruvnet avatar

Session Persist

This lets you checkpoint your AI agent's work and pick it back up later without losing context. It snapshots everything: agent state, memory entries, learning metrics, and task progress. You can save mid-conversation, list what you've saved, and restore by ID. The hook system can auto-save at session end or auto-restore at start, which is handy for long-running projects that span days. Honestly most useful when you're doing complex multi-step work and don't want to re-explain everything if you need to bail. It's basically version control for your conversation state.

skills.sh installs
775
GitHub stars
81.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add ruvnet/ruflo --skill session-persist --agent claude-code

Installs into .claude/skills of the current project.

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__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

Sponsors

Details

Repository
github.com/ruvnet/ruflo
Category
AI & Agent Building
First seen
Jun 3, 2026

More from ruvnet/ruflo

All 236
1cap-go avatarcapgo-cli-usagecap-go/capgo-skillsGuides the agent through the Capgo CLI command surface and routes requests to more specific Capgo skills. Use when the user asks generally about the Capgo CLI, 773skills.sh installs
2owainlewis avatarplanowainlewis/blueprintTurns an approved design or decided brief into ordered tasks for separate agent runs. Use for implementation tasks, tracker tickets, or useful milestones. Do no773skills.sh installs
3cap-go avatarcapacitor-plugin-upgradescap-go/capgo-skillsGuides the agent through upgrading a Capacitor plugin to a newer major version. Covers dependency alignment, native platform changes, example app verification, 772skills.sh installs
4code-yeongyu avatarpre-publish-reviewcode-yeongyu/oh-my-openagentNuclear-grade 16-agent pre-publish release gate. Runs /get-unpublished-changes to detect all changes since last npm release, spawns up to 10 ultrabrain agents f771skills.sh installs
5yoanbernabeu avatargrepai-embeddings-ollamayoanbernabeu/grepai-skillsConfigure Ollama as embedding provider for GrepAI. Use this skill for local, private embedding generation.770skills.sh installs
6lingfengqaq avatarwebnovel-reviewlingfengqaq/webnovel-writer使用审查 Agent 评估章节质量,生成报告并写回审查指标。766skills.sh installs