ClaudeNightsWatch

Claude Nights Watch 🌙

🚀 NEW: Now available as a Claude Code Plugin! 🎉

Autonomous task execution system for Claude CLI that monitors your usage windows and executes predefined tasks automatically. Built on top of the claude-auto-renew concept but instead of simple renewals, it executes complex tasks from a task.md file.

⚠️ Warning: This tool uses --dangerously-skip-permissions for autonomous execution. Use with caution!

🎯 Two Ways to Use Claude Nights Watch

Choose your preferred installation method:

🔥 Recommended: Claude Code Plugin (NEW!)
- Seamless Integration: Works directly within Claude Code
- 7 Slash Commands: /nights-watch start/stop/status/logs/task/setup/restart
- AI Agent Integration: Built-in Task Executor agent for autonomous guidance
- Smart Hooks: Automatic session integration and activity logging
- MCP Server: Programmatic control tools for Claude
- Enhanced UX: Better error handling and user experience

⚡ Original Daemon Method (Legacy)
- Standalone Operation: Works independently of Claude Code
- Script-based Control: Direct shell script execution
- Proven Reliability: Battle-tested daemon implementation
- Full Feature Set: All core functionality available

🎯 Overview

Claude Nights Watch extends the auto-renewal concept to create a fully autonomous task execution system. When your Claude usage window is about to expire, instead of just saying "hi", it reads your task.md file and executes the defined tasks autonomously.

Key Features

- 🤖 Autonomous Execution: Runs tasks without manual intervention
- 📋 Task-Based Workflow: Define tasks in a simple markdown file
- 🛡️ Safety Rules: Configure safety constraints in rules.md
- ⏰ Smart Timing: Uses ccusage for accurate timing or falls back to time-based checking
- 📅 Scheduled Start: Can be…