Kong/kongctl v0.5.0

on GitHub

kongctl Release Highlights

Welcome to kongctl v0.5.0! This release brings powerful new CLI capabilities, expanded declarative workflow support, and meaningful quality-of-life improvements for everyday Kong Konnect users.

✨ What's New

kongctl listen — Real-time Konnect Audit-Log Streaming

A brand-new listen command lets you subscribe to and stream Audit-Log events from Konnect in real time, giving you live visibility into Konnect activity, authorizations, API access, and more

kongctl listen --help
kongctl tail --help

kongctl lint — Validate Declarative Config

A new lint command validates your declarative configuration files before you apply them, catching errors early in the workflow.

kongctl lint -f config.yaml

kongctl patch file — File-based Patching

Apply partial updates to resources from a file, complementing the existing inline patch support.

kongctl patch file -f patch.yaml

kongctl delete -f — Bulk Declarative Cleanup

You can now use -f (file input) with the delete command to remove all resources described in a declarative input file — enabling clean, repeatable teardown of environments.

kongctl delete -f config.yaml

Expanded --jq Filter Support

The --jq flag for filtering output is now available across all get and list commands, making it easier to extract and script against specific fields.

kongctl get control-planes --jq '.items[].name'

🐛 Fixes & Improvements

• --jq with empty arrays: Fixed a bug where jq filters incorrectly returned null for empty array responses (#461).
• plan command flags: The -o/--output flag is now correctly rejected on the plan command, with improved error messages and examples (#450).
• Actionable arg errors: plan, diff, and sync now emit clear, actionable errors when unexpected positional arguments are passed (#451).
• TUI theme cycling: Real-time theme cycling in the TUI viewer improves terminal compatibility, especially in non-standard terminal emulators (#449).
• Improved API request/response logging: More structured and readable logs for HTTP interactions when using --log-level debug/trace (#457).
• Declarative API optimization: Reduced API calls in declarative sync operations for faster and more efficient plan/apply workflows (#464).
• Dependency updates: charmbracelet/bubbles v1, golang.org/x/term, golang.org/x/text.

📚 Docs & DX

• Developer site documentation is now prominently referenced in the main README (#469).
• AGENTS.md updated with flag-binding patterns for contributors (#448).
• Fixed incorrect -o flag usage in patch command examples (#440).
• Fixed the deck integration example (#441).

🔗 Commit References

Features

• a4aafe1 Add make mod target for dependency management (#422)
• 386b0c4 Add kongctl patch file command (#436)
• e2e2b72 Feat: Broadens support for --jq filters on get & list commands (#444)
• 2747d7c Feat: Improves logging for API request/response data (#457)
• 4218155 feat(view): add real-time theme cycling in TUI to improve terminal compatibility (#449)
• 91b88f0 Feat: Event Gateway Listeners (#365)
• a1e7911 Feat: Adding kongctl listen feature (#435)
• 0af8d47 Add kongctl lint command (#443)
• af4dc24 Feat: Adds kongctl delete -f support enabling broad resource cleanup from declarative inputs (#463)
• 654acb4 Feat: Improving kongctl release workflow (#472)

Fixes

• fd7ee37 Fix: Quick fix to the deck integration example (#441)
• fa60691 fix(deps): update module github.com/charmbracelet/bubbles to v1 (#453)
• 81d18b2 fix(deps): update module golang.org/x/term to v0.40.0 (#459)
• 9ef5b9b fix(deps): update module golang.org/x/text to v0.34.0 (#460)
• 4ddff53 fix: jq filter returns null for empty array responses (#461)
• 905d06b fix: reject -o/--output flag in plan command, fix misleading examples, and update e2e scenarios (#450)
• e788b01 Fix: Linter error on tail stream and fix for Makefile to match CI (#471)

Other Changes

• 3fe2bfc Configure weekly repo status to categorize discussions as Announcements (#426)
• 923f96f chore(deps): pin dependencies (#437)
• 0031161 Refactor tableview: reduce duplication, simplify control flow, optimize sorting (#434)
• daa6e3a Refactor verb switch statements to eliminate exhaustive matching overhead (#439)
• f278f1e refactor: introducing base resource and generic methods to reduce boilerplate code (#411)
• a2c29a0 refactor: introduced registry pattern for resources (#414)
• 0dbef34 Upgrade go version and golangci lint (#446)
• 4f6f559 refactor: Cleanup some command configurations (#447)
• b83a882 docs: Document flag binding pattern in AGENTS.md (#448)
• 30c6c75 cmd: reject positional args on plan/diff/sync with actionable error (#451)
• f854673 refactor: simplify ShouldUseColor by merging duplicate cases (#458)
• a355706 cmd: simplify sync command context setup for consistency with plan/diff (#466)
• ca8b56f Docs: Mention developer site documentation in main README (#469)
• 2078389 Task: Optimizes declarative Konnect API utilization (#464)

For full details, review the generated changelog entries below.

Full Changelog: v0.4.2...v0.5.0

Generated by Release