uroma 99cb591bf7 Enhance Ralph hook with background task spawning ...

BREAKING CHANGE: Ralph now runs as background process (non-blocking)

Changes:
- Enhanced ralph-auto-trigger.sh to spawn Ralph in background
- Hook immediately returns to Claude Code (NON-BLOCKING)
- Ralph runs via nohup (survives terminal close)
- Added PID tracking: ~/.claude/ralph.pid
- Added lock file: ~/.claude/ralph.lock
- Added log file: ~/.claude/ralph-output.log
- Added trigger log: ~/.claude/ralph-trigger.log
- Added RALPH_MAX_ITERATIONS environment variable (default: 50)

Features:
- Background execution: Claude Code continues immediately
- Process tracking: PID saved for monitoring/stopping
- Lock mechanism: Prevents duplicate Ralph instances
- Real-time monitoring: tail -f ~/.claude/ralph-output.log
- Graceful cleanup: Auto-cleanup of dead process locks

Updated files:
- MASTER-PROMPT.md: Enhanced hook script + usage instructions
- interactive-install-claude.sh: Enhanced install_ralph() function
- ~/.claude/hooks/ralph-auto-trigger.sh: Updated local installation

Usage:
- Ralph auto-starts in background when agents are requested
- Monitor: tail -f ~/.claude/ralph-output.log
- Stop: kill $(cat ~/.claude/ralph.pid)
- Configure: export RALPH_AUTO_MODE=agents|always|off
- Configure: export RALPH_MAX_ITERATIONS=100

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-01-16 10:03:31 +00:00

50 KiB

Executable File

Raw Blame History

View Raw