Workers

Workers are scheduled background tasks that run autonomously on a defined schedule.

Creating a Worker

lukan worker add

This interactive wizard helps you create a worker with:

Name and schedule
Prompt/task description
Tool permissions
Provider/model selection

Schedule Formats

Format	Example	Description
`every:Ns`	`every:30s`	Every N seconds (min 10s)
`every:Nm`	`every:5m`	Every N minutes
`every:Nh`	`every:2h`	Every N hours
Cron	`/10 * * *`	Standard cron syntax

Worker Definition

{
  "id": "a1b2c3",
  "name": "Check deployments",
  "schedule": "every:5m",
  "prompt": "Check if any deployments failed and notify me",
  "tools": ["Bash", "WebFetch"],
  "provider": "anthropic",
  "model": "claude-sonnet-4-5-20250929",
  "enabled": true,
  "notify": ["web", "whatsapp"]
}

Notifications

Workers can send notifications via:

"web" - Sends notification to web UI via WebSocket
"whatsapp" - Sends notification via WhatsApp

Managing Workers

lukan worker list                # List all workers
lukan worker add                 # Create worker interactively
lukan worker remove <id>         # Delete a worker
lukan worker pause <id>          # Pause a worker
lukan worker resume <id>         # Resume a worker
lukan worker runs <id>           # Show recent runs

Worker Daemon

Workers run through a background daemon. Manage it with:

lukan daemon start               # Start the worker daemon
lukan daemon stop                # Stop the worker daemon
lukan daemon status              # Show daemon status

The daemon automatically restarts workers on configuration changes and cleans up stale runs on startup. Each worker keeps a maximum of 20 recent runs.

Storage

Definitions: ~/.config/lukan/workers.json
Run history: ~/.config/lukan/workers/<id>/<run-id>.json

CLI

Configuration

Extensions

Advanced

Creating a Worker

Schedule Formats

Worker Definition

Notifications

Managing Workers

Worker Daemon

Storage

​Creating a Worker

​Schedule Formats

​Worker Definition

​Notifications

​Managing Workers

​Worker Daemon

​Storage

Creating a Worker

Schedule Formats

Worker Definition

Notifications

Managing Workers

Worker Daemon

Storage