sma task

Task system command group.

Hierarchy note: sma task is a service action command, not a top-level command. Top-level entry is sma service.

Usage

sma task <subcommand> [options]

Subcommands

• list
• create
• run <taskId>
• update <taskId>
• delete <taskId>
• status <taskId> <enabled|paused|disabled>
• enable <taskId>
• disable <taskId>

create key options

• --title <title> (required)
• --description <description> (required)
• --context-id <contextId> (required, task execution context identifier)
• --cron <cron> (default @manual)
• --activate (same as --status enabled)
• --kind <agent|script>
• --time <ISO8601> (with timezone; recommended with --cron @manual)

update common options

• --cron / --timezone / --status
• --required-artifact <path> (repeatable)
• --clear-required-artifacts
• --min-output-chars / --clear-min-output-chars
• --max-dialogue-rounds / --clear-max-dialogue-rounds

Examples

sma task list
sma task create --title "Daily check" --description "Run tests" --context-id telegram-chat-123 --activate
sma task run daily-check
sma task update daily-check --cron "0 10 * * 1-5"
sma task disable daily-check

Notes

Task scheduling requires a running runtime:

sma agent on

Task runs do not auto-send completion messages to chat channels; check the task run directory for results.