Skip to main content

lumio trigger

Send input to a running lumio dev session from another terminal in the same project. The CLI reads .lumio/dev-server.json to find that session and uses the same command path as the sandbox and REPL. Start lumio dev first.

lumio trigger twitch:follower
lumio trigger twitch:subscribe --tier 2 --field user_name=Alice
lumio trigger kick:reward --field reward.title=Hydrate
lumio trigger @big-sub

The event factory fills unspecified fields with reproducible values. Your fields are merged into that payload and checked against the protocol schema. Use field=value, --field a.b=value, or --<field> value for a field; --data '{"tier":"2000"}' and --file payload.json supply JSON objects. A preset such as @big-sub comes from lumio/mocks/events/big-sub.json.

Other inputs​

lumio trigger chat "!points 100" --user alice --role moderator
lumio trigger reward "Hydrate" --user alice --input "hello" --platform kick
lumio trigger reward-status redemption-1 accepted
lumio trigger music skip
lumio trigger scenario raid viewers=500
lumio trigger --timer reminder
lumio trigger --storage 'counter={"value":3}'

Chat, reward, and scenario commands use the session's mock viewers, rewards, music player, and bot-module runtime. --storage sets mock extension storage; --timer fires a declared timer. They can precede an event in the same invocation.

Repeated and random runs​

lumio trigger twitch:follower --count 50 --rate 5/s
lumio trigger --random --count 20 --rate 2/s --platform kick --seed 42
lumio trigger scenario --random --count 10
lumio trigger chat "!points" --count 20 --rate 2/s

--count accepts 1–10,000 runs. --rate needs --count; it accepts rates such as 5/s, 120/m, or 600/h, up to 1,000 per second. --random selects a fresh forwarded event type, or a scenario name, for each run. --platform filters random events to one platform. --seed reproduces random selections; lumio dev --seed controls generated event fields. Use --quiet to show the summary and errors during a load. The first failed run stops the load; Ctrl+C stops the trigger command.

Event types and payload shapes come from @zaflun/lumio-protocol. Unknown types or invalid fields fail before delivery.