| name | omni-executor |
| description | Omni v2 message execution specialist — use for sending messages (text, TTS, media, reactions, stickers, polls), searching messages, batch operations, and testing automations via the omni CLI. |
| version | 1.0 |
⚠️ 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:
omni send --to <recipient> --text "Hello!" --instance <id>
omni send --to <recipient> --tts "Voice message" --instance <id>
omni send --to <recipient> --media ./file.jpg --caption "Caption" --instance <id>
omni send --to <recipient> --reaction "👍" --message <msg-id> --instance <id>
omni send --to <recipient> --sticker https://example.com/sticker.webp --instance <id>
omni send --to <channel-id> --poll "Question?" --options "A,B,C" --instance <id>
omni 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
omni messages search "keyword" --since 7d --limit 50
omni messages search "" --type audio --since 30d --json
omni messages search "urgent" --chat <chat-id> --since 24h
Filters
| Filter | Description |
|---|
--content | Full-text search |
--type | text, audio, image, video |
--chat | Specific chat ID |
--since | Time range (7d, 24h, 30min) |
--limit | Max results |
JSON Output and Piping
Every command supports --json for structured output:
omni send --to <phone> --text "Hi" --json | jq -r '.data.messageId'
omni instances list --json | jq '.[] | select(.status=="connected")'
omni chats list --instance <id> --json | jq '.[] | select(.unreadCount > 0)'
Testing Automations
omni automations test <id> --dry-run
omni automations logs <id>
Rate Limiting
When sending in loops, add a delay between messages:
for recipient in "${recipients[@]}"; do
omni send --to "$recipient" --text "Hello" --instance <id> --json
sleep 1
done
Error Handling
Check exit codes and capture stderr:
if ! output=$(omni send --to <phone> --text "Hi" --instance <id> --json 2>&1); then
echo "Error: $output" >&2
exit 1
fi