
inngest-api-cli
Use when operating Inngest API resources from the terminal with npx inngest-cli@latest api: Cloud/local run debugging, event-run lookup, function traces, function invocation, app syncs, webhooks, environments, keys, account checks, and Insights queries. Provides prescriptive command routing for agents: which CLI command to run for a run ID, event ID, app ID, function ID, Cloud environment, API key, missing ID, or potentially mutating operation. Use inngest-cli for dev server setup/general CLI workflows and inngest-api only when raw REST API v2 docs or OpenAPI fallback are needed.
- Installs
- 787
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/inngest/inngest-skills --skill inngest-api-cli- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads inngest-api-cli automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Inngest API CLI
For Cloud operations with connected MCP tools, use inngest-cloud first.
Keep this skill for explicit terminal/HTTP work or a capability missing from
MCP. Do not ask for an API key when OAuth MCP can complete the task.
Use this skill when the task is operational: inspect, debug, sync, invoke, or query Inngest API resources through the terminal. This skill is intentionally prescriptive so agents can act without guessing.
For general CLI setup, inngest dev, Docker, local testing, MCP setup, or
self-hosted inngest start, use inngest-cli. For code changes, pair this
with the domain skill that owns the code pattern: inngest-setup,
inngest-durable-functions, inngest-events, inngest-steps,
inngest-flow-control, inngest-realtime, or inngest-middleware.
First Move
Verify the current CLI surface before relying on memory:
npx inngest-cli@latest api --help
npx inngest-cli@latest api <command> --help
The active API command is inngest api. If prompt context or old docs mention
inngest alpha api, switch to inngest api.
Use inngest-api only when:
- The CLI does not expose the needed endpoint.
- The user explicitly asks for raw REST API v2.
- You need the OpenAPI spec or LLM API docs to resolve request shape.
For complete command flags, read references/cli-commands.md after this skill triggers.
Target Rules
- Local is the default target for
inngest api. - Cloud Production requires
--prod. - Non-production Cloud environments require
INNGEST_ENV=<name>or--env. - Prefer
INNGEST_API_KEYfor Cloud API access. - Do not pass API keys inline with
--api-key <secret>unless the user explicitly accepts process-list and transcript exposure. - Never write API keys, event keys, signing keys, webhook URLs, or decrypted secrets into source files, docs, fixtures, or final answers.
Common targets:
npx inngest-cli@latest api health
npx inngest-cli@latest api --prod get-account
INNGEST_ENV=staging npx inngest-cli@latest api --prod get-webhooks
npx inngest-cli@latest api --api-host http://127.0.0.1 --api-port 8288 health
Local Development
For local app work:
-
Start the user's app with local dev mode when applicable, for example
INNGEST_DEV=1 npm run dev. -
Start the dev server:
npx inngest-cli@latest dev -
Prefer Dev Server MCP tools, when available, to list local functions, send test events, inspect runs, and watch status.
-
Use
npx inngest-cli@latest api ...for API-compatible local checks, command-help verification, and workflows not exposed through MCP.
If the local API says the dev server is unavailable, start inngest dev or
switch to Cloud with --prod when the user is debugging deployed runs.
Command Routing
Use this table before asking the human for more context.
| Situation | Command path |
|---|---|
| Check CLI/API reachability | api health |
| Confirm Cloud auth | api --prod get-account |
| List environments | api --prod get-account-envs --limit 10 |
| List event keys | api --prod get-account-event-keys --limit 10 |
| List signing keys | api --prod get-account-signing-keys --limit 10 |
| List webhooks | api --prod get-webhooks |
| User gives a run ID | api --prod get-function-run <run_id> |
| Need step-level detail | api --prod get-function-trace <run_id> --include-output |
| User gives an event ID | api --prod get-event-runs <event_id> --limit 5 --include-output |
| Sync a known app ID | api --prod sync-app --app-id <app_id> --url <serve_url> |
| Invoke a known app/function ID | api --prod invoke-function --app-id <app_id> --function-id <function_id> --data '<json>' |
| Discover Insights tables | api --prod get-insights-tables |
| Discover event schemas for Insights | api --prod get-insights-event-schemas --limit 25 |
| Draft an Insights query | api --prod query-insights-prompt --prompt '<request>' |
| Run an Insights query | api --prod query-insights --query '<sql>' |
If a command accepts positional IDs, prefer positional IDs in examples because
they are shorter and match current help. Flag forms such as --run-id are also
accepted by the current CLI for many path parameters.
Debug a Run
When the user gives a run ID:
npx inngest-cli@latest api --prod get-function-run <run_id>
npx inngest-cli@latest api --prod get-function-trace <run_id> --include-output
Summarize status, failed spans, retry state, timing, error names/messages, and the likely code boundary to inspect. Do not paste full traces unless asked.
When the user gives an event ID:
npx inngest-cli@latest api --prod get-event-runs <event_id> --limit 5 --include-output
Pick the relevant run from the response, then fetch the run and trace. If multiple runs are plausible, explain the candidates and use timestamps, function IDs, or failure status to choose.
Missing IDs
Do not immediately ask the user for app IDs, function IDs, or run IDs.
Try, in order:
- Dev Server MCP tools, if available.
- The user's prompt, pasted dashboard URLs, logs, alert text, or stack traces.
- Repository config and Inngest serve definitions.
- Event ID lookup with
get-event-runs. - Current CLI help to see if discovery commands such as
get-functionsorget-apphave appeared.
Ask the user for the ID only after those sources cannot provide it.
Mutating Operations
Read before write. List or fetch the relevant resource first, then mutate only when target and intent are clear.
Confirm before running these against Cloud unless the user already specified the account/environment and exact intent:
create-envpatch-envcreate-webhooksync-appinvoke-function- Broad or expensive
query-insightscalls
For repeatable invocation tests, use a stable idempotency key:
npx inngest-cli@latest api --prod invoke-function \
--app-id <app_id> \
--function-id <function_id> \
--idempotency-key <stable_test_key> \
--data '{"example":true}'
For complex JSON, use --body-file to avoid quoting mistakes.
Insights
Use Insights when the question is analytic, when logs only give partial clues, or when the user asks about trends, frequency, volume, failures over time, or event/run data.
Start small:
npx inngest-cli@latest api --prod get-insights-tables
npx inngest-cli@latest api --prod get-insights-event-schemas --limit 25
npx inngest-cli@latest api --prod query-insights-prompt \
--prompt "Show failed functions in the last 24 hours"
Inspect generated SQL before running broad queries. Add limits and time windows when possible.
Output Handling
- CLI output is JSON. Parse it structurally before making decisions.
- Use
--rawonly when a downstream command needs exact response bodies. - If responses are paginated and
page.hasMoreis true, continue with--cursorwhen complete results are needed. - Treat missing
dataon list responses as an empty list unless an error is present. - Redact secrets, webhook URLs, token values, and sensitive payload fields in summaries.
Drift Handling
The CLI is beta. If behavior differs from this skill:
- Run top-level and command-specific help.
- Check
https://api-docs.inngest.com/llms.txt. - Check
https://api-docs.inngest.com/api-specs/v2.json. - Use the
inngest-apiskill for raw REST API fallback.
Some launch material may mention aliases such as get-run or
invoke-function-by-slug. Use them only if current api --help exposes them.
If absent, use get-function-run and invoke-function.
FAQ
What does the inngest-api-cli skill do?
Use when operating Inngest API resources from the terminal with npx inngest-cli@latest api: Cloud/local run debugging, event-run lookup, function traces, function invocation, app syncs, webhooks, environments, keys, account checks, and Insights queries. Provides prescriptive command routing for agents: which CLI command to run for a run ID, event ID, app ID, function ID, Cloud environment, API key, missing ID, or potentially mutating operation. Use inngest-cli for dev server setup/general CLI workflows and inngest-api only when raw REST API v2 docs or OpenAPI fallback are needed.
How do I install inngest-api-cli?
Run npx skills add https://github.com/inngest/inngest-skills --skill inngest-api-cli in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/inngest-api-cli/ (personal) or .claude/skills/inngest-api-cli/ (project).
Which AI agents can use inngest-api-cli?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is inngest-api-cli safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains inngest-api-cli?
It is published by inngest in inngest/inngest-skills. It has 787 recorded installs.
More from inngest/inngest-skills
inngest-durable-functions
inngest/inngest-skills
Use when building functions that must survive process crashes, retry automatically on failure, run on a schedule, react to events, or maintain state across infrastructure failures — e.g., webhook handlers that drop events, flaky cron jobs, background jobs that fail mid-execution, or workflows that need to resume where they left off. Covers Inngest function configuration, triggers (events, cron, invoke), step execution and memoization, idempotency, cancellation, error handling, retries, logging, and observability.
inngest-events
inngest/inngest-skills
Use when designing event-driven workflows, decoupling services, implementing fan-out patterns (one trigger, many downstream handlers), implementing idempotent event handling with IDs (24-hour dedupe window), or handling at-least-once delivery from external sources like Stripe webhooks. Covers Inngest event schema, payload format, naming conventions, IDs for idempotency, the ts param, fan-out patterns, and system events like inngest/function.failed.
inngest-steps
inngest/inngest-skills
Use when implementing delays that must survive process restarts (e.g., 24-hour cart abandonment, scheduled follow-ups), waiting for human approval or external events with timeouts (review gates, webhook callbacks, async API completion), polling external services without losing state on crashes, calling other functions and awaiting their results, memoizing expensive operations so they don't re-run on retry, or running async work in parallel inside a workflow. Covers Inngest step methods: step.run, step.sleep, step.waitForEvent, step.waitForSignal, step.sendEvent, step.invoke, step.ai, plus patterns for loops and parallel execution.
inngest-setup
inngest/inngest-skills
Use when adding durable execution to a TypeScript project — building retry-safe webhook handlers, background jobs that survive crashes, scheduled tasks, or long-running workflows that outlive a single request. Covers Inngest SDK installation, client config, environment variables, serve endpoints (Next.js, Express, Hono, Fastify), connect-as-worker mode, and the local dev server.
inngest-middleware
inngest/inngest-skills
Use when adding cross-cutting concerns to durable functions — structured logging or tracing across all functions, error tracking with Sentry, payload encryption for sensitive data, dependency injection of clients (DB, Stripe, etc.) into function handlers, custom telemetry, or behavior that should apply uniformly across many functions. Covers Inngest middleware lifecycle, creating custom middleware, dependencyInjectionMiddleware, @inngest/middleware-encryption, @inngest/middleware-sentry, and custom middleware patterns.
inngest-flow-control
inngest/inngest-skills
Use when handling external API rate limits (e.g., OpenAI 429s, HubSpot or Stripe rate limits), preventing duplicate work from rapid event bursts (debouncing user actions), spreading load over time, ensuring per-tenant fairness, processing events in batches, limiting concurrent runs of the same operation, or assigning priority to important runs. Covers Inngest flow control: concurrency limits with keys, throttling, rate limiting, debounce, priority, singleton, and event batching.
Popular backend & apis skills
find-skills
vercel-labs/skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
entra-app-registration
microsoft/azure-skills
Guides Microsoft Entra ID app registration, OAuth 2.0 authentication, and MSAL integration. USE FOR: create app registration, register Azure AD app, configure OAuth, set up authentication, add API permissions, generate service principal, MSAL example, console app auth, Entra ID setup, Azure AD authentication. DO NOT USE FOR: Key Vault secrets (use azure-keyvault-expiration-audit), general Azure resource security guidance.
google-agents-cli-adk-code
google/agents-cli
This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management" — in a project that needs ADK (Agent Development Kit) API patterns and code examples. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, state management, the graph Workflow API, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).
embedded-captions
heygen-com/hyperframes
Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet anchor rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.
entra-agent-id
microsoft/azure-skills
Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant) including the Microsoft Entra SDK for AgentID sidecar. USE FOR: Agent Identity Blueprint, BlueprintPrincipal, agent OAuth, fmipath token exchange, agent OBO, Workload Identity Federation for agents, polyglot agent auth, Microsoft.Identity.Web.AgentIdentities. DO NOT USE FOR: standard Entra app registration (use entra-app-registration), Microsoft Foundry agent authoring (use microsoft-foundry).
neon
neondatabase/agent-skills
Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, the AI Gateway, and Realtime. Start here to choose Neon for undecided login, files, APIs, and LLM calls, set up the CLI or MCP server, and follow the branch-first workflow. Use when building an app or backend on Neon, or when "Neon" or "Lakebase Postgres" is mentioned. Child skill neon-postgres wins for an existing DATABASEURL, SQL, schema, inspect, or search. Child skill neon-auth wins for login, users, sessions, identity routing, and Managed Better Auth setup. Child skill neon-realtime wins for live queries in reactive apps and agents. Also use for object storage, S3, buckets, serverless functions, function triggers, cron, AI gateway, LLM calls, realtime, logs, Loki, Grafana, observability, postgres, database, backend, Claimable Neon, neon.new, or a no-signup database.