Sleepless Agent Documentation¶

Welcome to the Sleepless Agent documentation! This guide will help you understand, configure, and use the 24/7 AI agent that works while you sleep.

What is Sleepless Agent?¶

Sleepless Agent is an autonomous AI system that transforms your Claude Code Pro subscription into a 24/7 AgentOS. It processes tasks via Slack commands, manages isolated workspaces, and optimizes Claude usage across day and night cycles.

Key Features¶

• 🤖 Continuous Operation: Runs as a daemon, always ready for new tasks
• 💬 Slack Integration: Submit and manage tasks through Slack commands
• 🎯 Hybrid Autonomy: Auto-processes random thoughts, requires review for serious tasks
• ⚡ Smart Scheduling: Optimizes execution based on priorities and usage limits
• 📊 Persistent Storage: SQLite-backed task queue with full history
• 🏗️ Workspace Isolation: Each task runs in its own isolated environment
• 📈 Usage Optimization: Intelligent Pro plan usage management

Documentation Overview¶

📚 Getting Started¶

• Quickstart - Get running in 5 minutes
• Installation - Detailed setup instructions
• FAQ - Frequently asked questions

🧠 Core Concepts¶

• Architecture - System design and components
• Task Lifecycle - How tasks flow through the system
• Workspace Isolation - Understanding isolated environments
• Scheduling - Task prioritization and execution
• Pro Plan Management - Usage optimization strategies

📖 Guides¶

• Slack Setup - Configure your Slack application
• Environment Setup - Configure environment variables
• Git Integration - Automated commits and PRs
• Project Management - Organizing tasks into projects
• Deployment - Production deployment strategies

🎓 Tutorials¶

• First Task - Create your first automated task
• Slack Workflows - Build effective command workflows
• Monitoring Tasks - Track execution and results
• Daily Reports - Understanding generated reports
• Workspace Management - Managing task workspaces

📋 Reference¶

• CLI Commands - Complete command reference
• Slack Commands - Slash command reference
• Configuration - All configuration options
• Database Schema - SQLite schema details
• Environment Variables - Variable reference

💡 Examples¶

• Basic Usage - Simple usage patterns
• Slack Integration - Slack workflow examples
• Advanced Workflows - Complex task patterns
• Custom Executors - Extending functionality

Quick Links¶

• GitHub Repository
• Discord Community
• Issue Tracker
• Changelog

System Requirements¶

• Python 3.11+
• Claude Code CLI (@anthropic-ai/claude-code)
• Slack workspace with admin access
• SQLite 3
• Git (optional, for automation)

Getting Help¶

• Check the FAQ for common questions
• Review Troubleshooting for solutions
• Join our Discord for community support
• Open an issue for bugs

Contributing¶

We welcome contributions! See our Contributing Guide for details.

License¶

Sleepless Agent is released under the MIT License.