orchestratorlisted
Install: claude install-skill muhammad-anas35/Nexus-ai-employee
# Orchestrator
Master process that coordinates all watchers, processes approvals, triggers Claude Code, and manages the overall AI Employee workflow.
## Overview
The Orchestrator is the central nervous system of your AI Employee. It manages all background processes, schedules tasks, monitors health, and ensures smooth operation of the entire system.
## Usage
```bash
# Start the orchestrator (runs all watchers)
python scripts/orchestrator.py
# Start with specific watchers only
python scripts/orchestrator.py --watchers gmail,filesystem
# Run in daemon mode (background)
python scripts/orchestrator.py --daemon
# Check status
python scripts/orchestrator.py --status
```
## What It Does
1. **Manages all watchers** (Gmail, WhatsApp, filesystem)
2. **Monitors process health** and auto-restarts failures
3. **Schedules periodic tasks** (dashboard updates, processing)
4. **Processes approval workflow** (moves approved items)
5. **Triggers Claude Code** at appropriate times
6. **Logs all orchestration events**
## Architecture
```
Orchestrator (Master Process)
├── Watcher Manager
│ ├── Gmail Watcher
│ ├── WhatsApp Watcher
│ └── Filesystem Watcher
├── Scheduler
│ ├── Periodic task processing
│ ├── Dashboard updates
│ └── Approval checks
├── Health Monitor
│ ├── Process watchdog
│ ├── Auto-restart
│ └── Alert on failures
└── Approval Processor
├── Check /Approved folder
├── Execute actions
└── Move to /Done
```
## Configuration
### Environment Vari