session-manager

Manages cross-session continuity for Claude Code with structured handoffs and session state tracking.

4|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/Arete-Consortium/ai-skills --skill session-manager-arete-consortium
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-manager
Source: https://github.com/Arete-Consortium/ai-skills/tree/main/personas/claude-code/session-manager
Command: npx skills add https://github.com/Arete-Consortium/ai-skills --skill session-manager-arete-consortium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Claude Code sessions are ephemeral, so context, decisions, and in-progress work are lost between sessions. This Skill preserves project state across sessions by discovering prior work, loading handoff documents, and generating structured handoffs at session close. ## Core Features & Use Cases - Session Resume: Detects prior session state from .workflow/ files, git history, and plan files, then presents a session brief with completed, in-progress, and blocked items. - Structured Handoffs: Generates markdown handoff documents and JSON session state files capturing decisions, files modified, and prioritized next actions. - Parallel Session Sync: Synchronizes multiple concurrent agent sessions, flagging file conflicts without auto-resolving them. - Use Case: You run a swing-shift workflow where an evening session must pick up exactly where the morning session stopped. Session-manager reads the prior handoff, verifies git state, and resumes from the exact next action. ## Quick Start Ask Claude to resume your previous session and summarize what was completed, what is in progress, and the recommended next actions.

Frequently Asked Questions about session-manager

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

FAQPage Schema
How do I resume a previous Claude Code session?▼

Invoke the session resume flow, which reads the most recent WFS session file and handoff document from the .workflow directory, checks git log and status, then presents a session brief with completed, in-progress, and blocked items plus recommended next actions.

How do I hand off work between Claude Code sessions or agents?▼

Run the session complete flow at the end of your session. It generates a markdown handoff document covering completed work, decisions with rationale, blocked items, and prioritized next actions, plus a JSON state file for programmatic recovery.

Can session-manager handle parallel agent sessions?▼

Yes, the session sync flow reads all active session files in .workflow/active, pulls in commits from other sessions, and flags conflicts when two sessions modified the same file. Conflicts are presented to the user and never auto-resolved.

Where does session-manager store session state?▼

Session state lives in a .workflow directory with active/ holding WFS-<timestamp> JSON files and handoffs/ holding markdown handoff documents. Older sessions are archived to .workflow/archive after 20 active files accumulate.

When should I not use session-manager?▼

Skip it for self-contained one-shot tasks where session overhead is unjustified, and for full project planning, which belongs to a conductor-style skill. It tracks state and context, not requirements or specifications.