Alerts
Configure and manage alerts for CCO operations, task completions, and system events.
Overview
CCO supports configurable alerts that notify you when specific events occur during task execution or system operations. Alerts can be delivered via multiple channels including webhooks, email, and Slack.
Alert Types
| Type | Description |
|---|---|
task_complete |
Fired when a task completes successfully |
task_failed |
Fired when a task fails or encounters an error |
task_guarded_blocked |
Fired when a guarded task is blocked by guardrails |
system_error |
Fired when a system-level error occurs |
config_changed |
Fired when configuration is modified |
memory_threshold |
Fired when AOMA memory approaches capacity |
cco alerts list
List all configured alert rules.
Parameters
| Parameter | Type | Description |
|---|---|---|
--json |
optional | Output as JSON |
Examples
bash
# List all alert rules cco alerts list # JSON output cco alerts list --json
cco alerts add
Add a new alert rule.
Parameters
| Parameter | Type | Description |
|---|---|---|
--type |
required | Alert type (see Alert Types above) |
--target |
required | Webhook URL or notification target |
--filter |
optional | Filter expression for alert conditions |
--enabled |
default: true | Enable or disable the alert |
Examples
bash
# Notify on task completion cco alerts add --type task_complete --target https://hooks.slack.com/... # Notify on failures only cco alerts add --type task_failed --target https://api.example.com/alerts # Disable after adding cco alerts add --type system_error --target https://example.com/webhook --enabled false
cco alerts remove
Remove an alert rule.
Parameters
| Parameter | Type | Description |
|---|---|---|
--id |
required | Alert rule ID to remove |
--force |
optional | Skip confirmation prompt |
Examples
bash
# Remove an alert cco alerts remove --id alert_001 # Force remove cco alerts remove --id alert_001 --force
cco alerts test
Send a test notification for an alert rule.
Parameters
| Parameter | Type | Description |
|---|---|---|
--id |
required | Alert rule ID to test |
Examples
bash
# Test an alert cco alerts test --id alert_001