Event Triggers

NATS Event → Topic Match → Filter Check → Cooldown Check → Prompt → Agent Session

ravi triggers add "<name>" \
  --topic "<pattern>" \
  --message "<prompt>" \
  [--agent <id>] \
  [--cooldown <duration>] \
  [--session <main|isolated>] \
  [--filter '<expression>']

whatsapp.*.reaction     # use ravi.inbound.reaction
whatsapp.*.inbound      # channel messages are routed to sessions, not trigger subjects
ravi.*.tool             # session runtime subjects are blocked for triggers

data.<path> <operator> "<value>"
data.<path> <operator> "<value>" && (data.<path> <operator> "<value>" || !data.<path> <operator> "<value>")

# Only fire for events in a specific directory
ravi triggers set <id> filter 'data.cwd startsWith "/workspace/ravi"'

# Exclude events from a directory
ravi triggers set <id> filter 'data.cwd != "/workspace/fm"'

# Match a specific event type
ravi triggers set <id> filter 'data.permission_mode == "bypassPermissions"'

# Match events containing a keyword
ravi triggers set <id> filter 'data.output includes "error"'

# Match events ending with a suffix
ravi triggers set <id> filter 'data.tool endsWith "_list"'

# Match an approval reaction from one sender
ravi triggers set <id> filter 'data.senderId == "5511999999999" && (data.emoji == "👍" || data.emoji == "👍🏻")'

# Exclude one source
ravi triggers set <id> filter '!(data.source == "test")'

# Remove a filter
ravi triggers set <id> filter -

# Simple template
ravi triggers add "Session Monitor" \
  --topic "ravi.*.cli.sessions.*" \
  --message "Session CLI command executed. Check if the result looks correct."

# Template with truncated content
ravi triggers add "Copilot Watcher" \
  --topic "ravi.copilot.stop" \
  --message 'CC stopped in {{data.cwd}}. Last message: "{{data.last_assistant_message}}". Notify me if relevant, otherwise @@SILENT@@.'

[Trigger: Contato alterado]
Topic: ravi.agent:main:main.cli.contacts.add
Data: {
  "event": "end",
  "tool": "contacts_add",
  "output": "Contact added: abc123"
}

Analyze the contact change and notify the group.

ravi triggers add "Error Alert" --topic "ravi.audit.denied" --message "..." --session isolated

ravi triggers add "Contact Alert" --topic "ravi.contacts.pending" --message "..." --session main

# Set cooldown when creating
ravi triggers add "Monitor" --topic "ravi.audit.denied" --message "..." --cooldown 1m

# Update cooldown on existing trigger
ravi triggers set <id> cooldown 30s

ravi triggers list

ravi triggers topics
ravi triggers topics --json

ravi triggers show <id>

ravi triggers add "<name>" --topic "<pattern>" --message "<prompt>" [options]

ravi triggers enable <id>
ravi triggers disable <id>

ravi triggers set <id> name "New Name"
ravi triggers set <id> message "New prompt text"
ravi triggers set <id> topic "ravi.*.cli.contacts.*"
ravi triggers set <id> agent vendas
ravi triggers set <id> session main
ravi triggers set <id> cooldown 30s
ravi triggers set <id> filter 'data.cwd startsWith "/workspace/ravi"'
ravi triggers set <id> filter -          # Remove filter

ravi triggers test <id>

{
  "_test": true,
  "message": "Test event fired via CLI",
  "timestamp": "2026-02-28T12:00:00.000Z"
}

ravi triggers rm <id>

ravi triggers add "Permission Alert" \
  --topic "ravi.audit.denied" \
  --message "Permission denied for {{data.agentId}} on {{data.denied}}. Review if this agent needs additional permissions." \
  --cooldown 1m \
  --session isolated

ravi triggers add "Contact Audit" \
  --topic "ravi.*.cli.contacts.*" \
  --message "A contact was modified. Log the change for auditing." \
  --session isolated

ravi triggers add "Permission Alert" \
  --topic "ravi.audit.denied" \
  --message "Permission denied for {{data.agentId}} on {{data.denied}}. Review if this agent needs additional permissions." \
  --cooldown 5m

ravi triggers add "Project Watcher" \
  --topic "ravi.*.cli.*.*" \
  --message "Activity detected in the project. Last action: {{data.last_assistant_message}}" \
  --filter 'data.cwd startsWith "/workspace/ravi/copilot"' \
  --cooldown 30s

ravi triggers add "Reaction Approval" \
  --topic "ravi.inbound.reaction" \
  --filter 'data.emoji includes "👍"' \
  --message "Reaction received for {{data.targetMessageId}}. Resolve local state by targetMessageId and continue only if a pending item matches." \
  --session isolated \
  --cooldown 5s

{
  "external_msg_123": {
    "domainId": "item_123",
    "destinationChatId": "chat_public",
    "status": "pending"
  }
}

ravi triggers list

nats sub "ravi.*.cli.contacts.*" --server nats://127.0.0.1:4223

ravi daemon logs -f

ravi triggers disable <id>
ravi triggers enable <id>

ravi triggers test <id>
ravi daemon logs -f

# Valid
data.cwd == "/workspace/ravi"
data.tool startsWith "contacts"
data.output includes 'error'
data.senderId == "5511999999999" && (data.emoji == "👍" || data.emoji == "👍🏻")
!(data.source == "test")

# Invalid (CLI add/set reject these)
cwd == "/workspace"          # Missing data. prefix
data.cwd = "/workspace"      # Single = is not valid
data.cwd == /workspace       # Missing quotes around value
data.cwd == "/workspace" &&  # Missing right side