Claude Session Keeper

Claude Session Keeper

🤖 Automatically optimize your Claude Code session timing with intelligent scheduling and daily resets.

What It Does

Claude Code uses fixed 5-hour session windows that start with your first message. This script gives you complete control over when those windows begin:

- ✅ 5-Hour Session Optimization - Control exactly when your Claude Code sessions start
- ✅ Daily Reset Feature - Fresh sessions every day at your preferred time
- ✅ Smart Scheduling - Never waste sessions on random timing
- ✅ Minimal Resource Usage - 1 message per window vs 10-800 limit
- ✅ 24/7 Operation - Perfect for Raspberry Pi or always-on systems
- ✅ Automatic Timezone Detection - Works anywhere in the world

How Claude Code Sessions Work

Claude Code limits work with fixed 5-hour windows:
1. Window starts with your first message
2. Once you hit your limit (10-800 messages), you're locked out
3. Window expires exactly 5 hours after the first message
4. This script controls when that first message happens 🎯

Without this script: Random session timing based on when you happen to use Claude
With this script: Predictable, optimized sessions that align with your schedule

🚀 Features

⏰ Precise Timing Control
- Unix timestamp scheduling - Start at exact moments
- Resume functionality - Pick up where you left off after restarts
- Smart conflict resolution - Daily resets override 5-hour schedules

🌅 Daily Reset Feature
- Fresh sessions every day at your chosen time (e.g., 8:00 AM)
- Automatic schedule adjustment - 5-hour cycles restart from daily reset
- Work-day optimization - Clean slate every morning

🔍 Comprehensive Monitoring
- Real-time logging - See exactly what Claude Code is doing
- Daily schedule display - Know today's planned check times
- Countdown timers - Track…