GitHub - Coastal-Programs/inggest-cli: CLI for monitoring, debugging, and managing Inngest functions. Built for AI agents, shell scripts, and CI/CD pipelines.

██╗███╗   ██╗███╗   ██╗ ██████╗ ███████╗███████╗████████╗     ██████╗██╗     ██╗
██║████╗  ██║████╗  ██║██╔════╝ ██╔════╝██╔════╝╚══██╔══╝    ██╔════╝██║     ██║
██║██╔██╗ ██║██╔██╗ ██║██║  ███╗█████╗  ███████╗   ██║       ██║     ██║     ██║
██║██║╚██╗██║██║╚██╗██║██║   ██║██╔══╝  ╚════██║   ██║       ██║     ██║     ██║
██║██║ ╚████║██║ ╚████║╚██████╔╝███████╗███████║   ██║       ╚██████╗███████╗██║
╚═╝╚═╝  ╚═══╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚══════╝   ╚═╝        ╚═════╝╚══════╝╚═╝

IMPORTANT NOTICE:

This is an independent, unofficial command-line tool for working with Inngest's API. This project is not affiliated with, endorsed by, or sponsored by Inngest, Inc. "Inngest" is a registered trademark of Inngest, Inc.

Inngest CLI for AI Agents & Automation -- a single Go binary, no runtime dependencies.

A command-line interface for monitoring, debugging, and managing Inngest functions from the terminal. Built in Go with Cobra, optimized for AI coding assistants, shell scripts, and CI/CD pipelines.

Key Features:

Single binary: zero runtime dependencies, instant startup
AI-first design: JSON output by default, structured errors, clean exit codes
Non-interactive: perfect for scripts and automation
Flexible output: JSON, text, or table formats
Cloud + local: works with both Inngest Cloud and the local dev server
Real-time monitoring: watch runs, compute metrics, check health
Near-zero supply chain risk: 2 Go dependencies (cobra, pflag)

Quick Start

Installation

Option 1: Go install

go install github.com/Coastal-Programs/inggest-cli/cmd/inngest@latest

Requires Go 1.26+.

Option 2: Build from source

git clone https://github.com/Coastal-Programs/inggest-cli.git
cd inggest-cli
make build      # → ./build/inngest
make install    # → $GOPATH/bin/inngest

Setup

# Authenticate with your signing key
inngest auth login

# Check auth status
inngest auth status

# List your functions
inngest functions list

# See recent runs
inngest runs list --since 1h

Commands

Authentication

# Log in with an API key (recommended for CLI/CI/agents; Settings → API keys)
inngest auth login --api-key <key>

# ...or a signing key (interactive prompt or --signing-key flag)
inngest auth login

# Check current auth status (validates the credential against the API)
inngest auth status

# Clear stored credentials
inngest auth logout

Credential precedence: INNGEST_API_KEY > INNGEST_SIGNING_KEY > config api_key > config signing_key.

Functions

Command	Description
`inngest functions list`	List all functions with triggers and config
`inngest functions get <slug-or-id>`	Get detailed function info
`inngest functions config <slug-or-id>`	Show function configuration (concurrency, throttle, retry, etc.)
`inngest functions invoke <slug-or-id>`	Invoke a function directly and get the run ID

# Filter by app name or ID
inngest functions list --app my-app

# Table view
inngest functions list --output table

# Full config details
inngest functions config my-app-process-order

# Invoke with data and wait for the result
inngest functions invoke my-app-process-order --data '{"orderId": "abc"}' --wait

Runs

Command	Description
`inngest runs list`	List function runs (server-side filters, cursor pagination)
`inngest runs get <run-id>`	Get run details, output and trace
`inngest runs trace <run-id>`	Show the step-by-step trace tree
`inngest runs cancel <run-id>`	Cancel a running function
`inngest runs replay <run-id>`	Replay a function run
`inngest runs watch`	Watch for new runs in real-time

# Filter by status, function, app and time range (max 100 per page)
inngest runs list --status FAILED,CANCELLED --since 1h --limit 50
inngest runs list --function <fn-id> --app <app-id> --since 2024-01-01T00:00:00Z --until 12h

# Next page: pass page.cursor from the previous response
inngest runs list --after <cursor>

# Get run details, or block until it finishes
inngest runs get 01HXYZ... --output text
inngest runs get 01HXYZ... --wait

# Watch runs live
inngest runs watch --function <fn-id> --interval 5s

Events

Command	Description
`inngest events send <event-name>`	Send an event (Event API with an event key, otherwise REST API)
`inngest events get <event-id>`	Get event details and triggered runs
`inngest events list`	List recent events
`inngest events types`	List event types seen in the environment (`--schema` for inferred data shapes)

# Send an event with data
inngest events send test/user.signup --data '{"userId": "123"}'

# Pipe data from stdin, or read a file
echo '{"userId": "456"}' | inngest events send test/user.signup
inngest events send test/user.signup --data-file payload.json

# List recent events of a specific type; paginate with --after <internal_id>
inngest events list --name user.signup --since 1h

Environments

Command	Description
`inngest env list`	List all environments of the account
`inngest env use <name>`	Set the active environment
`inngest env get <name-or-id>`	Get detailed environment info

Apps

Command	Description
`inngest apps list`	List apps (SDK deployments); `--archived` for archived ones
`inngest apps get <app-id>`	Get app details including its latest sync
`inngest apps sync <app-id> --url <serve-url>`	Re-sync an app's functions from its serve endpoint

Raw API access

inngest api calls any endpoint of the Inngest REST API with your credentials — the escape hatch for anything not wrapped above:

inngest api /v2/runs?limit=5
inngest api /v2/runs/<run-id>/cancel -X POST
inngest api /v2/insights/query -X POST --body-file query.json

Dev Server

Command	Description
`inngest dev status`	Check if the local dev server is running
`inngest dev functions`	List functions registered with the dev server
`inngest dev runs`	List recent function runs from the dev server
`inngest dev send <event-name>`	Send an event to the dev server
`inngest dev invoke <function-slug>`	Invoke a function on the dev server
`inngest dev events`	List recent events from the dev server

# Check dev server status
inngest dev status

# Send a test event locally
inngest dev send test/user.signup --data '{"userId": "123"}'

# Invoke a function directly
inngest dev invoke my-app-process-order --data '{"orderId": "abc"}'

The dev server runs at http://localhost:8288 by default. Override with --dev-url. Every cloud command also works against the dev server with the global --dev flag (e.g. inngest runs get <id> --dev).

Monitoring

Command	Description
`inngest health`	Run connectivity and configuration health checks
`inngest metrics`	Show run metrics and success/failure rates
`inngest backlog`	Show currently queued and running runs per function

# Health check all systems
inngest health

# Metrics for the last hour
inngest metrics --since 1h

# See what's queued
inngest backlog --output table

Config

Command	Description
`inngest config show`	Show all configuration values
`inngest config get <key>`	Get a single configuration value
`inngest config set <key> <value>`	Set a configuration value
`inngest config path`	Print the config file path

Global Flags

Flag	Default	Description
`--env`, `-e`	`production`	Target environment by name or ID
`--output`, `-o`	`json`	Output format: `json`, `text`, `table`
`--dev`	`false`	Route requests to local dev server
`--api-url`		Override API base URL (for self-hosted Inngest; credentials are only sent over `https://` or to localhost)
`--dev-url`		Override dev server URL
`--timeout`	`30s`	Per-request timeout

Exit Codes

Code	Meaning
`0`	Success
`1`	Error (bad input, API or network failure)
`2`	Interrupted (Ctrl+C / SIGTERM)
`4`	Credential rejected by the API (401/403)

A rejected credential never produces an empty result with exit 0.

Output Formats

All commands support three output formats via --output:

json (default) — structured JSON, ideal for piping to jq or parsing in scripts
text — human-readable key-value output
table — tabular output for terminal viewing

inngest functions list --output table
inngest runs list -o json | jq '.runs[].status'

Configuration

Config is stored in the OS config directory (0600 permissions): ~/.config/inngest/cli.json on Linux, ~/Library/Application Support/inngest/cli.json on macOS, %AppData%\inngest\cli.json on Windows. inngest config path prints the resolved location.

Environment Variables

Variable	Description
`INNGEST_API_KEY`	API key for Inngest Cloud API access (recommended)
`INNGEST_SIGNING_KEY`	Signing key for Inngest Cloud API access
`INNGEST_EVENT_KEY`	Event key for sending events via the Event API
`INNGEST_CLI_CONFIG`	Override config file path

Environment variables take precedence over config file values.

# View all settings and their sources
inngest config show

# Set a value
inngest config set active_env staging

Architecture

Built in Go with a focus on simplicity, reliability, and minimal dependencies.

CLI framework: Cobra for command parsing and flag handling
HTTP client: Raw net/http — no SDK dependency
API: Inngest REST API v2 (runs, functions, apps, envs, invoke, trace) and v1 (events); the dev server's GraphQL API when --dev is set
Config: Environment variables + JSON config file
Output: JSON / text / table via pkg/output.Printer
Dependencies: 2 direct Go modules (cobra, golang.org/x/term) — 5 in go.mod including indirect, near-zero supply chain risk

Contributing

make check      # fmt-check + vet + lint — non-mutating, run before every commit
make fmt-check  # verify formatting without modifying files
make fmt        # auto-format Go source files
make fix        # auto-fix formatting + lint issues
make test       # run all tests with race detector
make build      # build binary to ./build/inngest
make hooks      # install git hooks via lefthook (opt-in)

Git hooks are managed with lefthook and are opt-in. Run make hooks (after installing lefthook) to enable a pre-commit gate (gofmt + go vet) and a pre-push test run.

See CONTRIBUTING.md for setup, code style, testing requirements and the pull request process.

Security

Found a vulnerability? Please do not open a public issue — see SECURITY.md for how to report it privately, and for how the CLI stores and redacts your credentials.

License

MIT

Name		Name	Last commit message	Last commit date
.claude		.claude
.gg		.gg
.github		.github
bin		bin
cmd/inngest		cmd/inngest
internal		internal
npm		npm
pkg/output		pkg/output
scripts		scripts
.editorconfig		.editorconfig
.gitignore		.gitignore
.golangci.yml		.golangci.yml
.npmignore		.npmignore
AGENTS.md		AGENTS.md
ARCHITECTURE.md		ARCHITECTURE.md
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
SECURITY.md		SECURITY.md
THIRD_PARTY_NOTICES.md		THIRD_PARTY_NOTICES.md
go.mod		go.mod
go.sum		go.sum
install.js		install.js
lefthook.yml		lefthook.yml
package.json		package.json

Navigation Menu

Uh oh!

Repository files navigation

Quick Start

Installation

Setup

Commands

Authentication

Functions

Runs

Events

Environments

Apps

Raw API access

Dev Server

Monitoring

Config

Global Flags

Exit Codes

Output Formats

Configuration

Environment Variables

Architecture

Contributing

Security

License

About

Releases

Packages

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Quick Start

Installation

Setup

Commands

Authentication

Functions

Runs

Events

Environments

Apps

Raw API access

Dev Server

Monitoring

Config

Global Flags

Exit Codes

Output Formats

Configuration

Environment Variables

Architecture

Contributing

Security

License

About

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages