⚠️ DEPRECATED: Superseded by atomic skills in plugins/omni/skills/. omni-orchestrator → use omni-instances/SKILL.md + omni-config/SKILL.md omni-executor → use omni-send/SKILL.md omni-analytics → use omni-events/SKILL.md

Omni Executor

Prerequisites

• omni CLI installed and in PATH (omni auth login --api-key sk_xxx --api-url <url>)
• jq available for JSON processing

Sending Messages

Use omni send with the appropriate flags for each message type:

bash
1# Text
2omni send --to <recipient> --text "Hello!" --instance <id>
3
4# TTS voice note
5omni send --to <recipient> --tts "Voice message" --instance <id>
6
7# Media (image, audio, video, document)
8omni send --to <recipient> --media ./file.jpg --caption "Caption" --instance <id>
9
10# Reaction
11omni send --to <recipient> --reaction "👍" --message <msg-id> --instance <id>
12
13# Sticker
14omni send --to <recipient> --sticker https://example.com/sticker.webp --instance <id>
15
16# Poll (Discord)
17omni send --to <channel-id> --poll "Question?" --options "A,B,C" --instance <id>
18
19# Embed (Discord)
20omni send --to <channel-id> --embed --title "Title" --description "Body" --instance <id>

Instance Resolution

The CLI matches instance IDs intelligently:

• Full UUID: 00000000-1111-2222-3333-444444444444
• UUID prefix: c3a4f
• Exact name: cezar-personal
• Substring: personal

Searching Messages

bash
1omni messages search "keyword" --since 7d --limit 50
2omni messages search "" --type audio --since 30d --json
3omni messages search "urgent" --chat <chat-id> --since 24h

Filters

JSON Output and Piping

Every command supports --json for structured output:

bash
1omni send --to <phone> --text "Hi" --json | jq -r '.data.messageId'
2omni instances list --json | jq '.[] | select(.status=="connected")'
3omni chats list --instance <id> --json | jq '.[] | select(.unreadCount > 0)'

Testing Automations

bash
1omni automations test <id> --dry-run
2omni automations logs <id>

Rate Limiting

When sending in loops, add a delay between messages:

bash
1for recipient in "${recipients[@]}"; do
2  omni send --to "$recipient" --text "Hello" --instance <id> --json
3  sleep 1
4done

Error Handling

Check exit codes and capture stderr:

bash
1if ! output=$(omni send --to <phone> --text "Hi" --instance <id> --json 2>&1); then
2  echo "Error: $output" >&2
3  exit 1
4fi