ClaudeLoop - Automated Claude Code Task Management

ClaudeLoop lets you run Claude Code while you sleep, eat, or play with your kids. Set up your tasks, hit start, and come back to completed work. This powerful VS Code extension provides fully automated Claude Code task management with intelligent queue processing and auto-resume functionality.

💤 "Queue up 100 tasks Friday evening, wake up Monday with everything done"

✨ Features

🚀 24/7 Automated Processing

• Set It and Forget It: Queue hundreds of tasks and let ClaudeLoop work autonomously
• Auto-Resume: Automatically resume processing when Claude usage limits reset - no manual intervention needed
• Sleep Prevention: Keeps your computer awake during processing so work continues overnight
• Smart Queue Management: Process multiple Claude Code tasks automatically with intelligent queueing
• Batch Processing: Handle large workloads efficiently - perfect for weekend or overnight runs

🔧 Robust Process Management

• Dependency Checking: Automatic detection and validation of Claude Code and Python dependencies
• Cross-Platform Support: Works seamlessly on Windows, macOS, and Linux
• IDE Compatibility: Full support for VS Code and Cursor
• Error Recovery: Comprehensive error handling with automatic retry mechanisms
• Health Monitoring: Continuous monitoring of Claude Code process health

⚙️ Advanced Configuration

• Extensive Settings: Fine-tune every aspect of ClaudeLoop behavior
• Configuration Validation: Built-in validation with helpful error messages
• Development Mode: Special features and debugging tools for developers
• Sleep Prevention: Keep your computer awake during long processing sessions

📊 Rich User Interface

• Interactive Webview: Intuitive interface for managing queues and monitoring progress
• Real-time Updates: Live status updates and progress tracking
• History Browser: Browse and filter previous processing runs
• Command Palette: Quick access to all ClaudeLoop commands

🚀 Quick Start

Prerequisites

1. Claude Code: Install Claude Code from https://www.anthropic.com/claude-code
2. Python 3.8+: Required for process management
3. VS Code 1.74.0+ or Cursor: Compatible with VS Code and Cursor

Installation

1. Install from VS Code Marketplace
2. Or install via command palette: Extensions: Install Extensions → Search "ClaudeLoop"
3. Or install from VSIX: code --install-extension claude-loop-0.0.1.vsix
4. Cursor: ClaudeLoop works seamlessly in Cursor with the same installation process

Basic Usage

1. Start ClaudeLoop: Open Command Palette (Cmd/Ctrl+Shift+P) → Claude: Start ClaudeLoop
2. Add Messages: Queue up all your tasks - add 10, 50, or 200+ messages
3. Start Processing: Click "Start Processing" and walk away
4. Live Your Life: Go eat dinner, play with kids, sleep, or enjoy your weekend
5. Return to Completed Work: ClaudeLoop handles everything automatically, even through Claude usage limits

📋 Commands

⚙️ Configuration

ClaudeLoop offers extensive configuration options. Access settings via File → Preferences → Settings → Extensions → ClaudeLoop.

Queue Management

{
  "claudeLoop.queue.autoMaintenance": true
}

Session Management

{
  "claudeLoop.session.autoStart": false,
  "claudeLoop.session.skipPermissions": true,
  "claudeLoop.session.healthCheckInterval": 30000
}

Sleep Prevention

{
  "claudeLoop.sleepPrevention.enabled": true,
  "claudeLoop.sleepPrevention.method": "auto"
}

History & Logging

{
  "claudeLoop.history.maxRuns": 20,
  "claudeLoop.history.autoSave": true,
  "claudeLoop.logging.enabled": false,
  "claudeLoop.logging.level": "info"
}

🏗️ Architecture

ClaudeLoop follows a modular architecture with clear separation of concerns:

src/
├── core/           # Core state, types, and configuration
├── claude/         # Claude CLI integration and communication
├── queue/          # Queue management and processing
├── services/       # External services (health, sleep, dependencies)
├── ui/             # User interface and webview management
└── utils/          # Shared utilities and logging

Key Components

• Queue Manager: Handles message queueing, processing, and operations
• Claude Integration: Manages Claude Code process and communication
• Dependency Checker: Validates and manages required dependencies
• Configuration System: Comprehensive settings with validation

🔒 Security & Privacy

• Local Processing: All processing happens locally on your machine
• No Data Collection: ClaudeLoop doesn't collect or transmit personal data
• Secure Dependencies: Validates Claude Code and Python installations
• Permission Awareness: Uses --dangerously-skip-permissions only in trusted environments

🛠️ Development

Building from Source

# Clone the repository
git clone https://github.com/benbasha/claudeloop.git
cd claudeloop

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Start watch mode for development
npm run watch

# Package for distribution
vsce package

Development Mode

Enable development mode for additional debugging features:

{
  "claudeLoop.developmentMode": true
}

This enables:

• Debug logging and diagnostics
• Configuration validation tools
• Advanced queue operations

🎯 Use Cases

Perfect for:

• Weekend Warriors: Queue up your entire week's refactoring Friday evening
• Large Refactoring Projects: Process hundreds of files while you sleep
• Batch Code Generation: Generate components, tests, and documentation overnight
• Migration Tasks: Convert frameworks or update dependencies during family time
• Quality Assurance: Run comprehensive code reviews while you're at dinner
• Documentation Generation: Create docs for your entire codebase while you relax

Real-World Examples:

• Converting a React class component codebase to functional components
• Adding TypeScript types to a large JavaScript project
• Generating API documentation from code comments
• Migrating from one testing framework to another
• Adding accessibility features across a web application

📚 Wiki & Documentation

Core Concepts

Queue Processing: ClaudeLoop maintains a persistent queue of messages that can be processed automatically. Each message represents a task or instruction for Claude Code.

Auto-Resume: When Claude Code hits usage limits, ClaudeLoop automatically detects this and schedules the queue to resume when limits reset.

Workspace Integration: Each VS Code workspace maintains its own queue and history, allowing you to manage multiple projects independently.

Dependency Management: ClaudeLoop automatically checks for and validates all required dependencies (Claude Code, Python) before starting.

Advanced Features

Batch Operations: Process multiple related tasks in sequence with consistent context and state management.

Queue Management: Full CRUD operations on queue items - add, edit, remove, duplicate, and reorder messages as needed.

History Tracking: Complete history of all processing runs with filtering and search capabilities.

Cross-Platform: Native support for Windows, macOS, and Linux with platform-specific optimizations.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on:

• Code style and conventions
• Testing requirements
• Pull request process
• Issue reporting
• Development environment setup

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Known Issues & Troubleshooting

Common Issues

Claude Code Not Found

• Ensure Claude Code is installed and in your PATH
• Restart VS Code after installing Claude Code
• Check dependency status in ClaudeLoop panel

Python Not Found

• Install Python 3.8 or later
• Ensure Python is in your PATH
• On Windows, check "Add Python to PATH" during installation

Permission Errors

• ClaudeLoop uses --dangerously-skip-permissions for automation
• Only use in trusted development environments
• Disable if working with sensitive data

Getting Help

• 🐛 Bug Reports
• 💡 Feature Requests
• 💬 Discussions
• 📖 Wiki Documentation

Support

If you find ClaudeLoop helpful, consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs or suggesting features
• 🤝 Contributing code or documentation
• 💬 Helping others in discussions

📈 Changelog

Version 0.0.2 (Latest)

• 🎨 NEW: Beautiful icon representing automation while sleeping
• ✨ Enhanced visual identity in VS Code marketplace
• 📦 Optimized package size and performance
• 🔍 Improved discoverability with professional branding

Version 0.0.1

• 🎉 Initial alpha release with Claude Code automation
• ✅ Complete architectural refactor from monolithic to modular design
• ✅ Implemented robust dependency checking and validation
• ✅ Added extensive configuration system with validation
• ✅ Enhanced error handling and recovery mechanisms
• ✅ Cross-platform compatibility improvements
• ✅ Production-ready code with development mode features
• ⚡ Queue processing and auto-resume functionality
• 💤 Sleep prevention during processing
• 📊 Basic history tracking

Made with ❤️ for the Claude Code community

ClaudeLoop is not affiliated with Anthropic or Claude AI. Claude Code is a product of Anthropic.