Claudenightswatch

Claude Nights Watch 🌙

[](https://opensource.org/licenses/MIT) [](https://www.gnu.org/software/bash/) [](https://docs.anthropic.com/claude-code) [](https://github.com/aniketkarne/ClaudeNightsWatch)

**🚀 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

...