session-handoff

Persist and restore Claude Code session context using Apple Notes.

2|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/fredchu/claude-dotfiles --skill session-handoff-fredchu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-handoff
Source: https://github.com/fredchu/claude-dotfiles/tree/main/skills/session-handoff
Command: npx skills add https://github.com/fredchu/claude-dotfiles --skill session-handoff-fredchu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the stateless nature of Claude Code sessions by preserving context across sessions, preventing the loss of work and decisions.

Core Features & Use Cases

  • Session State Persistence: Automatically saves the current session's state to Apple Notes before ending.
  • Context Restoration: Restores previous session context at the start of a new session via a hook.
  • Multi-Agent Memory: Supports a three-tier memory system (Active, Archive, Long-term) for individual and shared agent states.
  • Use Case: After a complex debugging session, the handoff note captures the current state of the code, the issues found, and the next steps, allowing you to pick up exactly where you left off in the next session.

Quick Start

Use the session-handoff skill to save your current progress before ending the session.

Frequently Asked Questions about session-handoff

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

FAQPage Schema
How do I persist Claude Code session context across multiple sessions?

You can persist Claude Code session context across multiple sessions by automatically saving the current state and decisions to Apple Notes before ending, then restoring that context at the start of the next session via a hook.

What is the best way to restore previous session state when starting a new Claude Code session?

Restoring previous session state at the start of a new Claude Code session is handled by a hook that reads the saved handoff note from Apple Notes, allowing you to pick up exactly where you left off.

Does session handoff work with Apple Notes for multi-agent memory synchronization?

Yes, session handoff works with Apple Notes to facilitate cross-agent communication and state synchronization, supporting a three-tier memory system for individual and shared agent states.

How does the three-tier memory system manage active, archived, and long-term knowledge?

The three-tier memory system manages active session state, archived history, and distilled long-term knowledge by persisting them as shared notes, enabling multi-agent context synchronization and preventing the loss of work.

Can I use session handoff to save complex debugging progress and next steps?

Yes, you can use session handoff to save complex debugging progress by capturing the current state of the code, issues found, and next steps in a handoff note before ending the session.

When do I need context persistence for stateless Claude Code sessions?

You need context persistence for stateless Claude Code sessions when you want to prevent the loss of work and decisions across multiple sessions, ensuring seamless state restoration for complex, ongoing tasks.