Automated Session State Management for Claude Code Handoff

Automated Context Preservation for Claude Sessions

A Reddit user has shared a solution for managing context degradation in Claude conversations, particularly addressing issues with autocompact and mid-conversation context loss as conversation windows grow large. The system automatically maintains a live state file throughout sessions without manual intervention.

How It Works

The solution expands on manual handoff commands by incorporating additional hooks:

• A UserPromptSubmit hook fires on every message sent, injecting a directive into Claude's system context that says "check if anything important happened, and if so, update session-state.md"
• A PostToolUse hook tracks which files Claude edits
• When session-state.md gets too long, the directive automatically switches to "rewrite mode" telling Claude to keep only critical information
• Before autocompaction, a PreCompact hook forces a full state dump so nothing is lost
• On session start, the previous session's state is loaded back in

Implementation Details

The automated system consists of approximately 4 shell scripts with no dependencies beyond bash and jq. Installation options include:

• Install as a git submodule
• Copy the hooks into .claude/hooks/ directory

The system maintains a live state file at .claude/session-state.md throughout the session. It also includes a manual /handoff command for deliberate checkpoints, useful for task tracking, bug investigations, and recovery from degraded context.

This type of tool is useful for developers working on complex, multi-session projects with Claude where maintaining context across conversations is critical for continuity and avoiding repetition.