{"id":48359768,"url":"https://github.com/coastal-programs/inggest-cli","last_synced_at":"2026-04-05T12:03:07.003Z","repository":{"id":346367434,"uuid":"1189578512","full_name":"Coastal-Programs/inggest-cli","owner":"Coastal-Programs","description":"CLI for monitoring, debugging, and managing Inngest functions. Built for AI agents, shell scripts, and CI/CD pipelines.","archived":false,"fork":false,"pushed_at":"2026-03-24T08:20:10.000Z","size":297,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-24T11:54:09.767Z","etag":null,"topics":["automation","cli","devtools","event-driven","golang","inngest","serverless"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Coastal-Programs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-23T13:14:22.000Z","updated_at":"2026-03-24T08:20:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Coastal-Programs/inggest-cli","commit_stats":null,"previous_names":["coastal-programs/inggest-cli"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Coastal-Programs/inggest-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coastal-Programs%2Finggest-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coastal-Programs%2Finggest-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coastal-Programs%2Finggest-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coastal-Programs%2Finggest-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Coastal-Programs","download_url":"https://codeload.github.com/Coastal-Programs/inggest-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Coastal-Programs%2Finggest-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31434625,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T08:13:15.228Z","status":"ssl_error","status_checked_at":"2026-04-05T08:13:11.839Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","cli","devtools","event-driven","golang","inngest","serverless"],"created_at":"2026-04-05T12:03:06.115Z","updated_at":"2026-04-05T12:03:06.981Z","avatar_url":"https://github.com/Coastal-Programs.png","language":"Go","readme":"\u003cdiv align=\"center\"\u003e\n\u003cpre\u003e\n██╗███╗   ██╗███╗   ██╗ ██████╗ ███████╗███████╗████████╗     ██████╗██╗     ██╗\n██║████╗  ██║████╗  ██║██╔════╝ ██╔════╝██╔════╝╚══██╔══╝    ██╔════╝██║     ██║\n██║██╔██╗ ██║██╔██╗ ██║██║  ███╗█████╗  ███████╗   ██║       ██║     ██║     ██║\n██║██║╚██╗██║██║╚██╗██║██║   ██║██╔══╝  ╚════██║   ██║       ██║     ██║     ██║\n██║██║ ╚████║██║ ╚████║╚██████╔╝███████╗███████║   ██║       ╚██████╗███████╗██║\n╚═╝╚═╝  ╚═══╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚══════╝   ╚═╝        ╚═════╝╚══════╝╚═╝\n\u003c/pre\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://go.dev/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/go-%3E%3D1.26-00ADD8.svg\" alt=\"Go Version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/Coastal-Programs/inggest-cli/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003c/div\u003e\n\n**IMPORTANT NOTICE:**\n\nThis is an independent, unofficial command-line tool for working with Inngest's API.\nThis project is not affiliated with, endorsed by, or sponsored by Inngest, Inc.\n\"Inngest\" is a registered trademark of Inngest, Inc.\n\n\u003e Inngest CLI for AI Agents \u0026 Automation -- a single Go binary, no runtime dependencies.\n\nA command-line interface for monitoring, debugging, and managing [Inngest](https://www.inngest.com) functions from the terminal. Built in Go with Cobra, optimized for AI coding assistants, shell scripts, and CI/CD pipelines.\n\n**Key Features:**\n- **Single binary**: zero runtime dependencies, instant startup\n- **AI-first design**: JSON output by default, structured errors, clean exit codes\n- **Non-interactive**: perfect for scripts and automation\n- **Flexible output**: JSON, text, or table formats\n- **Cloud + local**: works with both Inngest Cloud and the local dev server\n- **Real-time monitoring**: watch runs, compute metrics, check health\n- **Near-zero supply chain risk**: 2 Go dependencies (cobra, pflag)\n\n## Quick Start\n\n### Installation\n\n**Option 1: Go install**\n```bash\ngo install github.com/Coastal-Programs/inggest-cli/cmd/inngest@latest\n```\n\nRequires Go 1.26+.\n\n**Option 2: Build from source**\n```bash\ngit clone https://github.com/Coastal-Programs/inggest-cli.git\ncd inggest-cli\nmake build      # → ./build/inngest\nmake install    # → $GOPATH/bin/inngest\n```\n\n### Setup\n\n```bash\n# Authenticate with your signing key\ninngest auth login\n\n# Check auth status\ninngest auth status\n\n# List your functions\ninngest functions list\n\n# See recent runs\ninngest runs list --since 1h\n```\n\n## Commands\n\n### Authentication\n\n```bash\n# Log in with signing key (interactive prompt or --signing-key flag)\ninngest auth login\n\n# Check current auth status\ninngest auth status\n\n# Clear stored credentials\ninngest auth logout\n```\n\n### Functions\n\n| Command | Description |\n|---------|-------------|\n| `inngest functions list` | List all functions with triggers and config |\n| `inngest functions get \u003cslug\u003e` | Get detailed function info by slug |\n| `inngest functions config \u003cslug\u003e` | Show function configuration (concurrency, throttle, retry, etc.) |\n\n```bash\n# Filter by app\ninngest functions list --app my-app\n\n# Table view\ninngest functions list --output table\n\n# Full config details\ninngest functions config my-app-process-order\n```\n\n### Runs\n\n| Command | Description |\n|---------|-------------|\n| `inngest runs list` | List recent function runs |\n| `inngest runs get \u003crun-id\u003e` | Get run details (status, function, timing) |\n| `inngest runs cancel \u003crun-id\u003e` | Cancel a running function |\n| `inngest runs replay \u003crun-id\u003e` | Replay a function run |\n| `inngest runs watch` | Watch for new runs in real-time |\n\n```bash\n# Filter by status and time range\ninngest runs list --status FAILED --since 1h --limit 50\n\n# Get run details\ninngest runs get 01HXYZ... --output text\n\n# Watch runs live\ninngest runs watch --function my-func --interval 5s\n```\n\n### Events\n\n| Command | Description |\n|---------|-------------|\n| `inngest events send \u003cevent-name\u003e` | Send an event to Inngest Cloud |\n| `inngest events get \u003cevent-id\u003e` | Get event details and triggered runs |\n| `inngest events list` | List recent events |\n| `inngest events types` | List unique event names seen recently |\n\n```bash\n# Send an event with data\ninngest events send test/user.signup --data '{\"userId\": \"123\"}'\n\n# Pipe data from stdin\necho '{\"userId\": \"456\"}' | inngest events send test/user.signup\n\n# List recent events of a specific type\ninngest events list --name user.signup\n```\n\n### Environments\n\n| Command | Description |\n|---------|-------------|\n| `inngest env list` | List all environments (apps) |\n| `inngest env use \u003cname\u003e` | Set the active environment |\n| `inngest env get \u003cname-or-id\u003e` | Get detailed environment info |\n\n### Dev Server\n\n| Command | Description |\n|---------|-------------|\n| `inngest dev status` | Check if the local dev server is running |\n| `inngest dev functions` | List functions registered with the dev server |\n| `inngest dev runs` | List recent function runs from the dev server |\n| `inngest dev send \u003cevent-name\u003e` | Send an event to the dev server |\n| `inngest dev invoke \u003cfunction-slug\u003e` | Invoke a function on the dev server |\n| `inngest dev events` | List recent events from the dev server |\n\n```bash\n# Check dev server status\ninngest dev status\n\n# Send a test event locally\ninngest dev send test/user.signup --data '{\"userId\": \"123\"}'\n\n# Invoke a function directly\ninngest dev invoke my-app-process-order --data '{\"orderId\": \"abc\"}'\n```\n\nThe dev server runs at `http://localhost:8288` by default. Override with `--dev-url`.\n\n### Monitoring\n\n| Command | Description |\n|---------|-------------|\n| `inngest health` | Run connectivity and configuration health checks |\n| `inngest metrics` | Show run metrics and success/failure rates |\n| `inngest backlog` | Show currently queued and running runs per function |\n\n```bash\n# Health check all systems\ninngest health\n\n# Metrics for the last hour\ninngest metrics --since 1h\n\n# See what's queued\ninngest backlog --output table\n```\n\n### Config\n\n| Command | Description |\n|---------|-------------|\n| `inngest config show` | Show all configuration values |\n| `inngest config get \u003ckey\u003e` | Get a single configuration value |\n| `inngest config set \u003ckey\u003e \u003cvalue\u003e` | Set a configuration value |\n| `inngest config path` | Print the config file path |\n\n## Global Flags\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--env`, `-e` | `production` | Target environment by name or ID |\n| `--output`, `-o` | `json` | Output format: `json`, `text`, `table` |\n| `--dev` | `false` | Route requests to local dev server |\n| `--api-url` | | Override API base URL (for self-hosted Inngest) |\n| `--dev-url` | | Override dev server URL |\n\n## Output Formats\n\nAll commands support three output formats via `--output`:\n\n- **json** (default) — structured JSON, ideal for piping to `jq` or parsing in scripts\n- **text** — human-readable key-value output\n- **table** — tabular output for terminal viewing\n\n```bash\ninngest functions list --output table\ninngest runs list -o json | jq '.[].status'\n```\n\n## Configuration\n\nConfig is stored at `~/.config/inngest/cli.json` (0600 permissions).\n\n### Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `INNGEST_SIGNING_KEY` | Signing key for Inngest Cloud API access |\n| `INNGEST_EVENT_KEY` | Event key for sending events |\n| `INNGEST_CLI_CONFIG` | Override config file path |\n\nEnvironment variables take precedence over config file values.\n\n```bash\n# View all settings and their sources\ninngest config show\n\n# Set a value\ninngest config set active_env staging\n```\n\n## Architecture\n\nBuilt in Go with a focus on simplicity, reliability, and minimal dependencies.\n\n- **CLI framework**: [Cobra](https://github.com/spf13/cobra) for command parsing and flag handling\n- **HTTP client**: Raw `net/http` — no SDK dependency\n- **API**: GraphQL for queries (functions, runs, environments), REST for events\n- **Config**: Environment variables + JSON config file\n- **Output**: JSON / text / table via `pkg/output.Printer`\n- **Dependencies**: 2 Go modules (cobra, pflag) — near-zero supply chain risk\n\n## Contributing\n\n```bash\nmake check      # fmt + vet + test — run before every commit\nmake test       # run all tests with race detector\nmake build      # build binary to ./build/inngest\n```\n\n## License\n\n[MIT](LICENSE)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoastal-programs%2Finggest-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoastal-programs%2Finggest-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoastal-programs%2Finggest-cli/lists"}