CLI for interacting with Inngest's REST API - list events, send events, check run status, and cancel runs
npm install @ctdio/inngest-ctlCommand-line interface for Inngest events and runs.
``bashVia bunx (no install needed)
bunx @ctdio/inngest-ctl
$3
Install as an agent skill for AI-assisted Inngest operations:
`bash
npx skills install ctdio/inngest-ctl
`Once installed, your agent can query events, check run status, and manage Inngest functions directly.
$3
`bash
export INNGEST_EVENT_KEY="your-event-key" # Required for sending events
export INNGEST_SIGNING_KEY="your-signing-key" # Required for API queries
`Usage
`
inngest-ctl [options]Commands:
events Send and query events
runs Query function runs
cancel Cancel running functions
Global Options:
--pretty Human-readable output with colors
--output Write JSON output to file
--dev Use local dev server (default: localhost:8288)
--port Dev server port (default: 8288)
--help, -h Show help
--version, -v Show version
`Events
`
inngest-ctl events [options]Subcommands:
list List recent events
send Send an event
get Get event details
runs List runs triggered by an event
List Options:
--name Filter by event name
--limit Max events to return
Send Options:
--name Event name (required)
--data Event data as JSON (required)
--id Deduplication ID
--env Branch environment name
`Examples:
`bash
inngest-ctl events list --pretty
inngest-ctl events list --name "user.signup" --limit 10 --pretty
inngest-ctl events send --name "user.signup" --data '{"userId": "123"}'
inngest-ctl events get 01H08W4TMBNKMEWFD0TYC532GG --pretty
inngest-ctl events runs 01H08W4TMBNKMEWFD0TYC532GG --pretty
`Runs
`
inngest-ctl runs [options]Subcommands:
status Get run status and duration
get Get run details (jobs/steps)
list List runs for an event
List Options:
--event Event ID to list runs for
`Examples:
`bash
inngest-ctl runs status 01H08W5TMBNKMEWFD0TYC532GH --pretty
inngest-ctl runs get 01H08W5TMBNKMEWFD0TYC532GH --pretty
inngest-ctl runs list --event 01H08W4TMBNKMEWFD0TYC532GG
`Cancel
`
inngest-ctl cancel --app --function --started-after `Example:
`bash
inngest-ctl cancel --app my-app --function my-func --started-after 1h --started-before now
`Dev Server
Use
--dev flag to target local Inngest dev server:`bash
Start Inngest dev server
npx inngest-cli@latest devQuery local events
inngest-ctl events list --dev --prettySend event to local
inngest-ctl events send --name "test.event" --data '{}' --dev
`Override URL with
INNGEST_DEV_URL:
`bash
export INNGEST_DEV_URL="http://localhost:9000"
``MIT