claude-nights-watch

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 configured to start at a specific time
• 📊 Comprehensive Logging: Track all activities and executions
• 🔄 Based on Proven Code: Built on the reliable claude-auto-renew daemon

🚀 Quick Start

Prerequisites

1. Claude CLI installed and configured
2. (Optional) ccusage for accurate timing:

   npm install -g ccusage
   

---

🔥 Plugin Installation (Recommended)

Option 1: Install as Claude Code Plugin

# Method 1: From marketplace (when available)
claude plugins marketplace add https://github.com/aniketkarne/claude-plugins-marketplace
claude plugins add claude-nights-watch

# Method 2: Direct from GitHub
claude plugins add https://github.com/aniketkarne/ClaudeNightsWatch

# Method 3: From local directory (for development)
claude plugins add /path/to/ClaudeNightsWatch

Plugin Usage

# Interactive setup
/nights-watch setup

# Start daemon
/nights-watch start

# Check status
/nights-watch status

# View logs in real-time
/nights-watch logs -f

# Stop daemon
/nights-watch stop

Plugin Features:

• 🎯 7 Slash Commands: /nights-watch start/stop/status/logs/task/setup/restart
• 🧠 AI Agent: Built-in Task Executor for autonomous guidance
• 🔗 MCP Server: 8 programmatic tools for Claude control
• 🎣 Smart Hooks: Automatic session integration

---

⚡ Original Daemon Installation (Legacy)

Option 2: Install as Standalone Daemon

1. Clone this repository:

   git clone https://github.com/aniketkarne/ClaudeNightsWatch.git
   cd ClaudeNightsWatch
   

2. Make scripts executable:

   chmod +x *.sh
   

3. Run the interactive setup:

   ./setup-nights-watch.sh
   

Daemon Usage

1. Create your task file (task.md):

   # Daily Development Tasks
   
   1. Run linting on all source files
   2. Update dependencies to latest versions
   3. Run the test suite
   4. Generate coverage report
   5. Create a summary of changes
   

2. Create safety rules (rules.md):

   # Safety Rules
   
   - Never delete files without backing up
   - Only work within the project directory
   - Always create feature branches for changes
   - Never commit sensitive information
   

3. Start the daemon:

   ./claude-nights-watch-manager.sh start