Core Concepts¶

Understanding the fundamental concepts behind Sleepless Agent will help you use it more effectively.

Overview¶

Sleepless Agent is built on several core principles:

1. Continuous Operation - Runs 24/7 as a daemon
2. Workspace Isolation - Each task executes in isolation
3. Intelligent Scheduling - Optimizes task execution
4. Usage Management - Maximizes Claude Pro value

Key Concepts¶

📐 Architecture¶

Learn how the system components work together to process tasks autonomously.

• System components and their responsibilities
• Data flow through the system
• Communication patterns
• Extension points

🔄 Task Lifecycle¶

Understand how tasks move from creation to completion.

• Task states and transitions
• Execution phases
• Error handling and recovery
• Result storage

🏗️ Workspace Isolation¶

Explore how tasks run in isolated environments for safety and parallelism.

• Isolation principles
• Workspace types
• Security model
• Resource management

⏰ Task Scheduling¶

Discover how the scheduler prioritizes and executes tasks.

• Priority system
• Scheduling algorithm
• Queue management
• Resource allocation

📊 Pro Plan Management¶

Learn how the agent optimizes your Claude Pro subscription usage.

• Usage tracking
• Time-based thresholds
• Window management
• Optimization strategies

Concept Map¶

Sleepless Agent
├── User Input (Slack/CLI)
│   └── Task Creation
│       └── Queue Management
│           └── Scheduling
│               └── Execution
│                   ├── Workspace Isolation
│                   ├── Claude Code CLI
│                   └── Result Storage
├── Resource Management
│   ├── Pro Plan Usage
│   ├── System Resources
│   └── Time Windows
└── Automation
    ├── Git Integration
    ├── PR Creation
    └── Report Generation

Learning Path¶

For New Users¶

1. Start with Architecture for system overview
2. Read Task Lifecycle to understand task flow
3. Review Pro Plan Management for usage optimization

For Developers¶

1. Deep dive into Workspace Isolation
2. Study Scheduling algorithms
3. Explore extension points in Architecture

For Operators¶

1. Focus on Pro Plan Management
2. Understand Scheduling for optimization
3. Review monitoring in Task Lifecycle

Quick Reference¶

Related Topics¶

• Installation Guide - Set up the system
• Configuration Reference - Detailed settings
• First Task Tutorial - Hands-on experience
• FAQ - Common questions