Claude Auto-Resume System

Intelligentes Automatisierungssystem für robustes Claude CLI Session-Management mit automatischer Wiederherstellung nach Usage-Limits und Verbindungsfehlern.

Features

• 🤖 Vollautomatisierte Task-Verarbeitung - Automatische Abarbeitung aller ausstehenden Aufgaben ohne Benutzereingriff
• 🔄 Automatische Session-Wiederherstellung nach Usage-Limits
• ⏱️ Erweiterte Usage-Limit-Erkennung - Robuste PM/AM-Mustererkennung ("blocked until 3pm", "try again at 9am")
• 📊 Live-Countdown-Anzeige mit intelligenter Zeitstempel-Berechnung
• 🖥️ tmux-Integration für persistente Terminal-Sessions
• 🛡️ Fehlertolerante Wiederverbindung bei Netzwerkproblemen
• 🚀 Unüberwachter Betrieb - Kontinuierliches Monitoring ohne manuelle Eingriffe
• 📝 Strukturiertes Logging für Debugging und Monitoring
• 📋 Task Queue System für GitHub Issue-Management
• 🔧 Cross-Platform-Support (macOS, Linux)

Requirements

• Claude CLI - Anthropic Claude CLI
• Bash 4.0+ - Shell-Environment
• tmux - Terminal-Multiplexer
• jq - JSON-Processor
• claunch - Session-Management (wird automatisch installiert)

Unterstützte Plattformen: macOS 10.14+, Linux (Ubuntu 18.04+)

Installation

# Repository klonen
git clone https://github.com/trytofly94/Claude-Auto-Resume-System.git
cd Claude-Auto-Resume-System

# Automatische Installation mit Setup-Wizard
./scripts/setup.sh

# Oder manuelle Installation
chmod +x src/*.sh scripts/*.sh
./scripts/install-claunch.sh  # claunch installieren (optional)

Quick Start

# Core Automation - Vollautomatisierte Task-Verarbeitung
./src/hybrid-monitor.sh --queue-mode --continuous

# Standard Continuous Monitoring
./src/hybrid-monitor.sh --continuous

# Mit Debug-Ausgabe (empfohlen für erste Tests)
./src/hybrid-monitor.sh --queue-mode --continuous --debug

# Test-Modus (30 Sekunden)
./src/hybrid-monitor.sh --test-mode 30

# Hilfe anzeigen
./src/hybrid-monitor.sh --help

Task Queue (Optional)

# Task hinzufügen
./src/task-queue.sh add-custom "Fix authentication bug"

# GitHub Issue als Task
./src/task-queue.sh add-issue 123

# Status anzeigen
./src/task-queue.sh status

# Interactive Mode
./src/task-queue.sh interactive

Configuration

Konfigurationsdateien in config/:

• default.conf - Standardkonfiguration
• user.conf - Benutzerspezifische Einstellungen (optional)

Wichtige Parameter:

CHECK_INTERVAL_MINUTES=5      # Monitoring-Intervall
MAX_RESTARTS=50              # Maximale Neustarts
USAGE_LIMIT_COOLDOWN=300     # Wartezeit bei Usage-Limits (Sekunden)
LOG_LEVEL="INFO"             # Logging-Level

Troubleshooting

# System-Diagnose
make debug

# Logs prüfen
tail -f logs/hybrid-monitor.log

# Test-Suite ausführen
make test

Häufige Probleme

• "declare -A: invalid option": Bash 4.0+ erforderlich - brew install bash (macOS)
• claunch nicht gefunden: Wird automatisch installiert, sonst ./scripts/install-claunch.sh
• flock Warnung: Normal auf macOS, alternative Implementierung wird verwendet

Documentation

• DEPLOYMENT_GUIDE.md - Detaillierte Installationsanleitung
• CLAUDE.md - Projektspezifische Konfiguration
• docs/ - Entwicklerdokumentation
• CHANGELOG.md - Versionshistorie

Development

# Entwicklungsumgebung
make dev-setup

# Tests ausführen
make test

# Code-Qualität
make lint
make validate

# Development-Zyklus
make dev-cycle

Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

License

MIT License - siehe LICENSE für Details.

Credits

Basiert auf:

• terryso/claude-auto-resume - Original Auto-Resume System
• 0xkaz/claunch - Claude Launch Utility

---

Version: 1.1.0-stable | Status: Production Ready