fix(ralph-wiggum): add session isolation for stop hook #15853
+82
−14
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
The ralph-wiggum stop hook was triggering across ALL Claude Code sessions
instead of being isolated to individual sessions. This happened because
the state file was stored at a CWD-relative path (.claude/ralph-loop.local.md).
This fix introduces session-based state file isolation:
1. SessionStart hook: Extracts session_id from hook input and persists it
as CLAUDE_SESSION_ID environment variable via CLAUDE_ENV_FILE. This makes
the session ID available to command scripts.
2. Session-specific state files: State files are now stored in the plugin's
state/ directory as ${session_id}.md instead of a CWD-relative path.
3. Stop hook isolation: The stop hook now extracts session_id from its JSON
input and only checks for state files matching that specific session.
This ensures that starting a ralph-loop in one session doesn't block
other Claude Code sessions from exiting normally.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
nazt
added a commit
to laris-co/ralph-local
that referenced
this pull request
Jan 6, 2026
Merge upstream changes with our improvements:
NEW FILES:
- .gitignore: Ignore state/ directory
- hooks/session-start-hook.sh: Extract session_id from hook input
MODIFIED FILES:
- hooks/hooks.json: Add SessionStart hook
- hooks/stop-hook.sh: Use session-specific state files
- scripts/setup-ralph-loop.sh: Use CLAUDE_SESSION_ID for state path
- commands/ralph-loop.md: Update state file path reference
KEY CHANGES:
- State files now stored in ${PLUGIN_ROOT}/state/${SESSION_ID}.md
- Each session has isolated state (no cross-session interference)
- SessionStart hook captures session_id and persists as CLAUDE_SESSION_ID
- Kept our extensive error handling from original fork
Synced with: anthropics/claude-code#15853
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Fixes #15047
Related: #15790
Fixes the ralph-wiggum stop hook triggering across ALL Claude Code sessions instead of being isolated to individual sessions.
Problem: The stop hook checked for a state file at a CWD-relative path (
.claude/ralph-loop.local.md), which caused cross-session interference:This made it impossible to run ralph-loop in one session while using other Claude Code sessions normally in the same directory - they would all get pulled into the same loop.
Solution: Session-based state file isolation:
SessionStart hook: Extracts
session_idfrom hook input JSON and persists it asCLAUDE_SESSION_IDenvironment variable viaCLAUDE_ENV_FILE. This makes the session ID available to command scripts.Session-specific state files: State files are now stored in the plugin's
state/directory as${session_id}.mdinstead of CWD-relative paths.Stop hook isolation: Extracts
session_idfrom its JSON input and only checks for state files matching that specific session.Changes
hooks/session-start-hook.sh(NEW) - Persists session_id as CLAUDE_SESSION_IDhooks/hooks.json- Added SessionStart hook configurationhooks/stop-hook.sh- Uses session-specific state filesscripts/setup-ralph-loop.sh- Uses CLAUDE_SESSION_ID for state file namingcommands/ralph-loop.md- Updated state file path reference.gitignore(NEW) - Ignores state/ directoryTest plan
<plugin-root>/state/<session-id>.md🤖 Generated with Claude Code