Session Management

Persist session state and replay history from an event store using a session_id.

19|5|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/lukacf/meerkat --skill session-management-lukacf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Session Management
Source: https://github.com/lukacf/meerkat/tree/main/meerkat-session/skills/session-management
Command: npx skills add https://github.com/lukacf/meerkat --skill session-management-lukacf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Durable session persistence and replay for long-running workflows, ensuring continuity and auditable histories across runs.

Core Features & Use Cases

  • Durable realm-backed session store that materializes projected state under .rkat/sessions (not the canonical state)
  • Session resume and replay from the event store using a prior session_id
  • Configurable compaction thresholds to balance context size and performance

Quick Start

Start a new session and replay its history from the event store using a known session_id.

Frequently Asked Questions about Session Management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resume a long-running session after an interruption using a previous session_id?

To resume a long-running session after an interruption, you replay its history from the event store using the prior session_id. This reconstructs the full session state, ensuring durable continuity and an auditable history across runs.

What is event-store replay for durable session persistence?

Event-store replay for durable session persistence is the process of reconstructing a session's state by replaying its historical events. It ensures long-running workflows remain durable and auditable, allowing full state recovery across disruptions.

How do I configure compaction thresholds to balance context size and performance?

Configurable compaction thresholds allow you to balance context size and performance during session replay. By adjusting these settings, you control how much historical event data is retained versus compacted to optimize the durable store's efficiency.

Does session management support realm-backed durable stores for projected state?

Yes, session management supports a durable realm-backed session store that materializes projected state under .rkat/sessions. This projection is explicitly not the canonical state, but rather a durable view for managing long-running, interactive workflows.

When do I need durable session persistence and replay?

You need durable session persistence and replay for long-running, interactive sessions where interruptions occur. It is essential when your workflows require resume capabilities from a prior session_id and full historical reconstruction via an event store.

Why does my session state need projection instead of storing canonical state directly?

Your session state needs projection under .rkat/sessions instead of storing canonical state directly to maintain an auditable history. The realm-backed durable store projects state for recovery, while the event store retains the canonical event sequence for full replay.