Inngest CLI for querying events and function runs. Use this skill when you need to:
list Inngest events, send events, get event details, check run status, monitor job duration,
list runs for an event, or cancel running functions. Trigger phrases include "list events",
"send event", "event status", "run status", "check run", "cancel run", "inngest events",
"function runs", "job status".
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Instruções da origem · Visualização somente leitura
name
inngest-ctl
description
Inngest CLI for querying events and function runs. Use this skill when you need to:
list Inngest events, send events, get event details, check run status, monitor job duration,
list runs for an event, or cancel running functions. Trigger phrases include "list events",
"send event", "event status", "run status", "check run", "cancel run", "inngest events",
"function runs", "job status".
inngest-ctl Reference
A CLI tool for interacting with Inngest events and function runs.
IMPORTANT: ALWAYS use inngest-ctl for Inngest operations. NEVER fall back to raw curl commands, direct fetch calls, or constructing HTTP requests manually. The CLI handles authentication, URL construction, and response formatting automatically.
Setup
Running the CLI
# Via bunx (no install needed)
bunx @ctdio/inngest-ctl <command>
# Or create an aliasalias inngest-ctl="bunx @ctdio/inngest-ctl"
Environment Variables (Required)
export INNGEST_EVENT_KEY="your-event-key"# For sending eventsexport INNGEST_SIGNING_KEY="your-signing-key"# For API queries
For Local Dev Server
Use --dev flag:
inngest-ctl events list --dev --pretty
Override URL:
export INNGEST_DEV_URL=
"http://localhost:9000"
Commands
List Events
inngest-ctl events list [--name <name>] [--limit <n>] [--pretty] [--dev]
Examples:
inngest-ctl events list --pretty
inngest-ctl events list --name "user.signup" --limit 10 --pretty
inngest-ctl events list --dev --pretty
inngest-ctl cancel --app my-app --function my-func --started-after 1h --started-before now
Global Flags
Flag
Description
--pretty
Human-readable output with colors
--output <file>
Export results to JSON file
--dev
Use local dev server (localhost:8288)
--port <port>
Dev server port (default: 8288)
Common Workflows
Local Development
# Start Inngest dev server
npx inngest-cli@latest dev
# List local events
inngest-ctl events list --dev --pretty
# Send test event
inngest-ctl events send --name "test.event" --data '{"test": true}' --dev
# Check what runs it triggered
inngest-ctl events runs <event-id> --dev --pretty
# Monitor run status
inngest-ctl runs status <run-id> --dev --pretty
Debugging Function Runs
# 1. Find recent events
inngest-ctl events list --pretty
# 2. Get event details
inngest-ctl events get <event-id> --pretty
# 3. List runs triggered by the event
inngest-ctl events runs <event-id> --pretty
# 4. Check run status and duration
inngest-ctl runs status <run-id> --pretty
# 5. Get detailed job/step info
inngest-ctl runs get <run-id> --pretty
Production Monitoring
# List recent events for a specific type
inngest-ctl events list --name "user.signup" --limit 50 --pretty
# Check if a specific run completed
inngest-ctl runs status <run-id> --pretty
# Export event data for analysis
inngest-ctl events list --limit 100 --output events.json
Output Format
Default output is JSON. Use --pretty for colored human-readable output:
