session-management

Automate Claude Code session checkpoints with YAML frontmatter and MCP-safe state.

1|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/davidmoneil/AIfred --skill session-management-davidmoneil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-management
Source: https://github.com/davidmoneil/AIfred/tree/main/.claude/skills/session-management
Command: npx skills add https://github.com/davidmoneil/AIfred --skill session-management-davidmoneil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents context loss across Claude Code sessions by providing a unified workflow for starting, tracking, checkpointing, and ending sessions with consistent documentation.

Core Features & Use Cases

  • Automatic session initialization: loads session-state.md and current-priorities.md at session start.
  • Cross-project continuity: preserves institutional knowledge across projects and orchestrations.
  • Checkpointing and proper exit: enables On-Demand MCP restart safety and structured handoffs with documented procedures.

Quick Start

Start a new Claude Code session and observe the skill auto-load context. Review the loaded session-state.md and current-priorities.md, then begin by setting a short-term goal and running a checkpoint when preparing to move to another task.

Frequently Asked Questions about session-management

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

FAQPage Schema
How do I preserve context across Claude Code sessions?

To preserve context across Claude Code sessions, this Skill automates session management by loading session-state.md and current-priorities.md at start, enabling checkpointing, and documenting structured handoffs to prevent context loss.

What is the best way to checkpoint a Claude Code session before switching projects?

The best way to checkpoint a Claude Code session is using the Skill's manual commands to update priorities and trigger MCP-safe checkpoints, ensuring structured handoffs and context preservation before moving to another task or project.

Does session management for Claude Code work across multiple projects?

Yes, session management for Claude Code works across multi-project environments, preserving institutional knowledge and orchestration context by maintaining consistent session state and priority documentation throughout.

How does automatic session initialization load context in Claude Code?

Automatic session initialization loads context by implementing hooks that read session-state.md and current-priorities.md at session start, immediately restoring your previous priorities and institutional knowledge without manual intervention.

Can I use YAML frontmatter in SKILL.md for Claude Code session state?

Yes, you can use YAML frontmatter in SKILL.md to define session management configurations, with optional assets available for reference materials to support context preservation and checkpointing procedures.

When should I avoid relying on automatic context preservation in Claude Code?

You should avoid relying solely on automatic context preservation when preparing for MCP restarts; instead, trigger manual checkpoint commands to ensure safe handoffs and documented session exits before switching tasks.